Комментарии 8
Всегда смущало это сокращение - FAQ, как ругательство какое. Вопросы и ответы - лайк
Шаг 1. Набираем вопросы: можно вдохновиться ТЗ исходя из поставленных задач (вопросы), написать "ответы", т.е как работает продукт .
Да, согласна, в ТЗ и другой рабочей документации тоже можно поискать потенциальные вопросы.
Единственное, насчет "ответов" в кавычках я бы была осторожна. Имею в виду, чтоб не получилось, что под предлогом вопрос-ответов мы пишем полное описание сервиса. Я считаю, мы все же должны исходить из того, что реально может спросить реальный пользователь. В общем, главное, вдохновившись ТЗ, не написать вопрос вроде "Из каких основных модулей состоит ваш главный экран?" :-)
Дико плюсую пункту про «не говорите в вопросах на маркетинговом языке».
Я обращаюсь к справке в проблемной ситуации и, когда в справку пихают рекламу, у меня такое чувство, что вместо помощи, продукт пользуется моим «уязвимым» положением и пытается мне что-то навязать. У меня и так с продуктом проблемы, я точно не в настроении читать, какой он хороший. Появляется ощущение, что мне врут. От этого ни справке нет доверия, ни продукту.
Мне кажется, частая ошибка, я периодически встречаю. И да, сразу хочется закрыть, ты пришел с вопросом, а тебе рассказывают, как все прекрасно
Еще бывает, что какой-то возможности нет, и вместо того, чтобы кратко написать, что ее нет, мне начинают рассказывать, какие другие возможности зато есть. Будто так удастся отвлечь мое внимание :)
А вот тут наш канал о техническом писательстве t.me/protechnicalwriting
Как создать хороший FAQ