Тематический указатель для десятка разрозненных заметок
Соберите одну навигационную страницу, на которой читатель быстро найдёт ответ или следующий шаг.
За несколько месяцев учебный кружок накопил конспекты, ссылки на упражнения и объяснения типичных ошибок. Новичок открывает папку, видит список файлов по датам и спрашивает, с чего начать. Указатель не требует перестраивать весь архив. Достаточно отдельной страницы, которая связывает конкретные вопросы с небольшим числом проверенных заметок.
Выберите аудиторию и три вопроса
Сначала определите, кому нужен указатель. Для нового участника важны материалы первой встречи и способ проверить результат. Для ведущего важны подготовка и способы разбирать ошибки. Один список на все случаи быстро станет таким же длинным, как папка. Если разные роли ищут разные вещи, начните с одной роли и прямо назовите её в первом абзаце.
Возьмём тему «Схемы и диаграммы». У новичка могут быть три вопроса. Как выбрать подходящую диаграмму? Где найти набор для упражнения? Как проверить, что результат понятен другому человеку? Под каждый вопрос подберите по одному материалу. Если уверенного ответа пока нет, обозначьте пробел. Это полезнее, чем ссылаться на случайный конспект, в котором нужный ответ спрятан или отсутствует.
Сохраните ссылки вместе с пояснениями
В указателе используйте названия, понятные без исходного контекста. «Урок 7» знаком автору, но новичку полезнее «Выбрать диаграмму для сравнения чисел». Добавьте одно короткое предложение о результате. Оно помогает решить, открывать ли документ сейчас. Не пересказывайте на странице весь материал. Тогда исправление примера не потребует править его копию в двух местах.
## Начать
- [Выбрать диаграмму](choose-chart.md) — три вопроса перед построением.
- [Упражнение с расписанием](practice-schedule.md) — маленький набор данных.
- [Проверить подписи](check-labels.md) — сверка с читателем.Уточните назначение каждой ссылки. Один файл может служить образцом, другой — рабочей инструкцией, третий — объяснением причины. Когда они отличаются ролью, полезно указать это в тексте. Такая структура особенно помогает тем, кто пришёл за быстрым ответом и открыл статью с объяснением вместо инструкции. Для короткого списка хватит нескольких ясных глаголов.
Установите границу указателя
Включите в указатель материалы, которыми действительно готовы пользоваться. Черновики можно связать из отдельного раздела для авторов. Старую заметку с уже заменённым советом не выводите рядом с текущей без пояснения. Если она важна для истории, добавьте ссылку из действующего материала и подпишите, почему более ранний способ больше не применяется.
Не копируйте всё дерево папок. Одна заметка может находиться в папке проекта и при этом появляться в тематическом указателе. Это нормальная ситуация. Ссылка позволяет найти один и тот же источник через разные задачи. Когда документ переезжает, обновите путь и проверьте переходы. Не создавайте копию заметки только для того, чтобы она была видна в другом разделе.
В большом архиве полезно различать стартовую страницу и полное оглавление. Стартовая страница отвечает на самые частые вопросы. Полное оглавление помогает просматривать накопленное. Если сделать один документ для обеих задач, первое действие окажется далеко внизу. Начните с короткого указателя и добавьте из него переход к полному набору, если такой набор уже существует.
Проверьте на реальном поиске
Покажите указатель человеку, который не знает историю папки. Дайте ему одну задачу, например «найти образец для сравнения времени двух маршрутов». Пусть он открывает ссылки самостоятельно. Отметьте, какую подпись прочитал, где остановился и какой ответ нашёл. Проверка показывает, помогает ли подборка, а не просто нравится ли список.
Если человек открывает сразу несколько заметок и сравнивает их, выясните почему. Возможно, две подписи обещают один и тот же результат. Уточните первую или уберите вторую из стартового списка. Если он нашёл файл, но действие осталось непонятным, исправьте целевой документ или выберите другой. Проверка пригодности указателя включает содержимое назначения, а не только наличие ссылки.
Сделайте обслуживание частью работы
Когда появляется новая заметка, спросите, какой конкретный вопрос в указателе она закрывает. Если ответ уже есть, сравните материалы. Обновляйте ссылку, только когда новая заметка лучше подходит читателю, либо сохраните обе с различимыми назначениями. Дата создания сама по себе не делает заметку полезнее.
При ревизии прочитайте только названия и пояснения. Если из них не видно последовательности, переставьте ссылки. Если заметки давно не открывали, пройдите хотя бы первые переходы с устройством и правами читателя. Указатель готов, когда новичок может найти первый материал без подсказки, а автор может обновить список, не переписывая содержимое заметок. Для разных ролей добавляйте отдельные указатели только после появления конкретного поискового затруднения.
Выбирайте одну стартовую ссылку для каждого вопроса
Две одинаковые ссылки в указателе часто появляются после добавления нового конспекта. Прочитайте их целевые страницы и решите, какой материал подходит для первого действия. Если второй содержит объяснение исключения, свяжите его уже из первого. Так начальная страница останется короткой, а подробности доступны там, где они нужны. При обновлении проверьте, что указатель не обещает действие, которое исчезло из инструкции. Например, если образец больше не содержит таблицу, подпись «скачать таблицу» надо поправить вместе с заменой ссылки. Это небольшое обслуживание сохраняет доверие к списку.