Очень большой текст Principles of technical documentationwww.innoq.com/en/arti…entation, возвращающий нас во времена хороших требований из легендарного IEEE-830. Тем не менее, этот текст достоин прочтения, как пример проработанного текста с одной стороны и нелишнего повторения банальностей, типа: Automation won’t improve your content - с другой
This article collects fundamental requirements for technical
documentation, especially software architecture documentation, together
with ideas how to *satisfy* those.