Кто такой docs-as-code и почему его все хотят

Современная Россия славится многообразием инструментов для ведения базы знаний IT-проектов. Заценить аналоги Конфлю можнотут и тут.

Особняком 🎩 от всей этой импортозамещающей вечеринки стоят приверженцы подхода docs-as-code, которые ведут документацию прямо в Git 👏

Этот подход выглядит очень и очень серьезно

Да, ты не пишешь код, но несмотря на это недоразумение, всё равно будешь допущен к таким взрослым вещам как: 📌 pull-requests 📌 создание и merge веток 📌 прохождение review 📌 версионирование 📌 авто-публикация и CI/CD

В качестве чуть ли не основного аргумента в пользу хранения доки вместе с кодом приводят тезис о том, что документация всегда будет актуальной. Однако этого можно добиться и другими методами, без великой миграции многолетних архивов в Git.

Был ли у вас опыт перехода на docs-as-code? Какие выгоды вы получили? Или просто делитесь, что используете для документации, тоже интересно↘️