Хабр публикует вторую часть руководства по Docs as code — подходу к созданию техдокументации по правилам разработки. Автор подробно описывает, когда этот метод необходим: для снижения нагрузки на разработчиков при запуске портала документации, получения полного контроля над инфраструктурой (за счёт open-source и on-prem), обеспечения надёжного аудита изменений (Git, PR/MR), автоматизации проверки качества (линтеры, регэксп-проверки, тесты в CI/CD) и полной генерации документации из кода (OpenAPI → код и docs; Doxygen/JSDoc для SDK; библиотеки для CLI — click, commander.js).

Раздел с фундаментальными понятиями связывает инструменты подхода с тремя базовыми принципами: абстракция (объекты, атрибуты, состояние, поведение), синтаксис (лексика, структура, выражения/инструкции/определения, комментарии) и конфигурация (как реализация абстракции). Рассматриваются источники конфигурации (файлы .ini/.json/.yaml/.env и переменные окружения) и разделение по окружениям (dev, stage/sandbox, prod). Итог: Docs as code позволяет вынести разработчиков из контура поддержки портала, стандартизировать процессы, снизить риски вендор-локина и повысить воспроизводимость.