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