Техническая документация: писать так, чтобы читали
Документация - это код, который читают люди. Но большинство документации никто не читает. Почему? Потому что она написана для галочки, а не для пользы.
Хорошая документация экономит часы объяснений. Плохая - создаёт больше вопросов, чем ответов.
Читать далее