Справка разваливается, когда в ней смешаны цель, интерфейс и лишние объяснения. Рабочая структура для любой темы такая: 1) коротко назвать задачу; 2) показать, где она решается; 3) дать пошаговое действие; 4) добавить частые ошибки и что делать, если шаг не сработал.
Каждый шаг пишите как одно действие, без двух-трёх смыслов в одном пункте. Хорошо: «Откройте раздел “Платёжные данные”». Плохо: «Откройте раздел, проверьте карту, потом сохраните профиль». Если шаг длинный, разбейте его на подшаги или вынесите уточнение ниже.
Отдельно держите блоки: «Что нужно заранее», «Если нет доступа», «Если кнопка не видна». Так статья не превращается в простыню и легче обновляется. Ещё одно правило: не объясняйте очевидное, если это не помогает выполнить действие. Справка должна вести, а не учить всему подряд.
Проверьте текст по трём вопросам: читатель понимает, куда нажать; может повторить шаги без догадок; найдёт решение, если что-то пошло не так. Если на один вопрос ответ «нет», значит структуру надо упрощать.
FAQ Sites
@faqsites