Docs as Code — это когда люди посмотрели на вики, где можно было просто зайти и что‑то ...
Docs as Code — это когда люди посмотрели на вики, где можно было просто зайти и что‑то дописать, и решили: «Нет, слишком удобно, давайте сделаем сложнее». Раньше как было: открыл страницу, накатал текст, нажал «сохранить». Всё, документация обновлена. Теперь: – Создай ветку. – Обнови Markdown. – Пропусти через линтер. – Собери статический сайт. – Пройди код‑ревью по орфографии. – Подожди деплоя. Но главное — мы же теперь «как разработчики», значит, страдать надо по‑разработчески. Любимый момент — когда кто‑то искренне говорит: «У нас больше нет хаоса в документации, только репозиторий». И ты такой открываешь структуру: docs, docs-old, docs-legacy, docs-new, docs-rework, docs-v2-final-new. Поиск даёт 7 вариантов одной и той же схемы, отличающихся запятой в заголовке. Красота, единый источник правды прямо сияет. И вот так аккуратненько идея «документация как код» превращается в antiwiki. Формально всё верно: есть версии, история изменений, ревью, пайплайны. Фактически — любой нормальный человек, которому нужно просто понять «куда стучаться», видит git, CI, конфиги и такой: «Ладно, я лучше в чате спрошу». Живое знание снова переезжает в мессенджер, а статичный сайт гордо отображает то, что было правдой три релиза назад.