Docs as Code: документация, которая живёт вместе с кодом

Имхо. Непонятно про какую документацию речь. Например QA-шные тесткейсы из зефира хранить рядом с кодом? А подробное текстовое (человекопонятное) описание пользовательских сценариев? Много воды -- всю статью можно сократить до одного предложения "Старайтесь использовать для документации такой формат файлов который можно положить в репозиторий". У нас, например, используются подробные ридми в md-формате с описанием внешних интеграций, правил работы с кодом, инструкции как локально развернуть и т.п. в репозиториях проектов. Но пользовательская, менеждерская и QA-шная доки живут отдельно в удобных для исполнителей форматах