Участник:Petr-akhlamov/Советы по написанию статей
На данной странице я хочу расписать тезисы по написанию статей для пользователей по своим наблюдениям:
- не перепрыгивайте через ступеньки: если вы что-то знаете хорошо, не факт что читатель статьи знает то же. То что, возможно, для вас пустяки, для другого читателя может быть темный лес. Старайтесь прописывать шаги как можно подробней
- используйте шаблон Notes: делайте заметки для пользователя:
- указывающие на что стоит обратить внимание в данном разделе
- подтверждающие указанные значения, если вы предполагаете что у пользователя, как и у вас, могут возникнуть вопросы
- расписывающие указанные в строках значения
- Расписывайте, по возможности, возможные ошибки и их решения
- Пример: NetInstall_start#Ошибки
- Если описывается какая-то конфигурация из множества файлов, распишите их расположение с помощью tree и укажите их место
- Если расписывается настройка сервера, сборки и пр. опишите в Notes значения, которые будут использоваться в статье для примера, чтобы пользователь мог понять что на что ему заменять