Участник:Petr-akhlamov/Советы по написанию статей

На данной странице я хочу расписать тезисы по написанию статей для пользователей по своим наблюдениям:

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