Хабр опубликовал первую часть цикла о стратегиях разработки технической документации. Материал сравнивает четыре подхода — Single-source publishing, Docs as code, Knowledge bases и Files — по применимости, затратам и ограничениям.

• Single-source publishing: «пиши один раз — публикуй везде», переиспользование контента, консистентные стили и многоканальный экспорт; минусы — платные решения, высокий порог входа, часто фокус на Windows.
• Docs as code: хранение исходников в VCS, автоматическая сборка артефактов, рецензирование через PR/MR и бесчеловечный деплой; гибкость open-source, но требуются инженерные ресурсы и доступ к коду.
• Knowledge bases: низкий порог, роли и UI «как в справочном центре», но ограниченная расширяемость.
• Files: мощь редакторов (например, Word), знакомый UX, но риски несовместимости версий и зависимость от макросов.

Рекомендации по применению: API/CLI и SDK — преимущественно Docs as code (и частично Single-source), внешняя продуктовая документация — Single-source и/или Docs as code, внутренняя нетехническая — Knowledge base, при малом объёме — Knowledge base/Files. Далее цикл перейдёт к практикам Docs as code (части 2–3).