Хочу научиться писать понятные инструкции/документации/мануалы, ищу внезапные решения, может быть лучшие практики. Если что тред не ограничивается ЯП-ми, но кого если не программиста спрашивать как писать упорядоченные действия.
Вот некоторые советы, которые звучат как база: - Тостировать свои инструкции, воссоздавая с нуля - использовать рекурсивные уточнения - представлять себя в роли человека, которому придётся читать - заранее продумывать TL;DR и FAQ - описывать только то, что есть (без загадывания) - избыточность и уточнение очевидных пунктов - не пропускать пункты, даже если они повторяются - картинка > текста (Снег > текста)
Пишите свои дополнения к этому списку или просто хорошие практики.