Когда создавать отдельную страницу термина и когда хватит абзаца

Словарь на сайте полезен, когда термин отвечает на самостоятельный вопрос и ведёт к следующему действию. Разберём границу между коротким пояснением, словарной карточкой и подробным руководством.

Проверить самостоятельный вопрос
Проверьте, кто задаёт вопрос. Покупателю мебели нужно понять, что такое доводчик в его модели. Конструктору может понадобиться разбор типов, нагрузок и совместимости. Для двух аудиторий глубина объяснения различается.
Дерево выбора формата
| Ситуация | Формат |
|---|---|
| Редкое сокращение в одной инструкции | Расшифровка рядом |
| Пять коротких связанных терминов | Единый справочник |
| Есть сравнения, примеры и частые ошибки | Отдельная страница термина |
Привязать к продукту
Посмотрите, где термин уже встречается. Добавьте краткую расшифровку при первом появлении, а при наличии полноценной страницы поставьте осмысленную ссылку. Дайте словарной записи примеры применения и близкие понятия, которые часто путают.
Как выбрать место для термина
- Короткое пояснение — для редкого слова в одной инструкции.
- Словарная карточка — для самостоятельного вопроса с примером.
- Руководство — для расчёта, настройки или последовательности действий.
Выбрать место
Проверьте результат на трёх соседних терминах. Если каждое определение без примера дублирует одну строку паспорта, объедините их в тематический справочник. Большой материал разделяйте, когда появляются самостоятельные задачи.
Пример карточки термина
Для термина «канонический адрес» дайте одно предложение определения, пример двух URL и объяснение, почему редактор выбирает предпочтительную страницу. Затем поставьте ссылку на подробную инструкцию по дублированию адресов. Не превращайте словарную статью в сборник несвязанных справок. Если понятие встречается только однажды и помещается в короткую скобку, отдельная запись может не понадобиться.
Как отличить термин от будущей статьи
Проверьте, можно ли закрыть вопрос коротким определением и одним примером. Если читателю дальше понадобится расчёт или выбор модели, дайте переход к подробному руководству. Тогда словарь помогает разобраться в термине, а рядом есть следующий шаг.
Комментарий автора
Вопросы и ответы
Нужно ли делать словарь для всех слов отрасли?
Начните с терминов, которые мешают клиенту выбрать продукт или понять предложение. Остальные можно объяснять по месту.
Когда объяснить термин прямо внутри статьи?
Если его легко расшифровать одной фразой и читателю не нужны отдельные примеры или исключения.
Из чего собрать самостоятельную карточку?
Дайте определение, узнаваемый пример и границы применения, затем укажите подходящее продолжение темы.
Куда вести из определения технического термина?
В инструкцию по действию, связанному с понятием, либо в подходящую категорию, если читатель уже готов выбирать.
Как избежать дублирования подробного руководства?
Оставьте в словаре смысл термина и один пример. Расчёт и последовательность действий разместите на основной странице темы.