Посмотрел вакансии на hh по запросу «технический писатель». Чаще всего в требованиях попадались: «понимание подхода Docs-as-Code», «знание Markdown» и «опыт работы с Git». Из чего можно сделать вывод, что Docs-as-Code — это Markdown и Git.

Но докс-эс-код шире. Почему-то команды не используют остальные классные фишки. Например, еще можно:

— Переиспользовать контект И не описывать 20 раз одно и то же. А если изменить исходный текст, то его инстанс изменится во всех документах. Магия.

— Экспортировать документацию в нескольких форматах Одним кликом.

— Проверить текст на ошибки Мы используем Докумишку — наш внутренний инструмент основанный на нейронных сетях. Он проверяет текст перед публикацией и подсвечивает ошибки.

— Согласовать документы И вести список ответственных.

Да, это надо настроить. Но все мы знаем сколько ресурсов экономит автоматизация рутины.

Это того стоит 📄