Как я перевёл документацию из Word в Git и почему это прижилось В «Дилибриуме» я начинал техническим писателем, и многие документы тогда были в Word. Однажды руководитель компании попросил единую инструкцию: как писать, хранить и публиковать документацию по любому нашему проекту прямо из репозитория. Контур публикации я спроектировал и запустил сам. Что я собрал: 1. Источник один — Git. Документы писались в Markdown и лежали в закрытом репозитории (Gitea). Никаких копий «на всякий случай» и вопросов, какая версия последняя. 2. Сервер-посредник. Сайт не ходил в репозиторий сам. Это делала серверная функция-прокси в Yandex Cloud (Node.js): она читала закрытый репозиторий через API Gitea, а ключ доступа хранился только в переменных окружения на сервере. Сайт ничего не знал о ключах и только показывал документ. 3. Сайт для читателя. Документация встраивалась на страницу HTML-блоком, и у читателя было около 25 функций: поиск, оглавление, темы оформления, выгрузка в PDF, мобильная версия, кэширование. 4. Перенос старого. Для одной из собственных систем компании я перевёл 6 документов из Word в Markdown и собрал из них сайт документации. Код функции я писал вместе с ИИ-ассистентом: программирование не моя основная зона, но разобраться, что она делает и где хранится ключ, я обязан был сам. Потом по просьбе руководителя я оформил всё это как внутренний стандарт в Яндекс Вики: структура документации, роли, правила публикации. Отдельный текст оказался не менее важным, чем сам контур: когда правило записано, следующий проект подключается без старта с нуля. Так и вышло: к моему уходу по этому стандарту работали 2 сайта документации двух продуктов компании (один из них — конвертер Markdown → DOCX), на 6 и 7 документов. Оба сайта ходили через один и тот же адрес функции. Что я из этого вынес: — docs-as-code держится не на инструментах, а на одной договорённости, как писать, хранить и публиковать; — ключи и доступы проектируются сразу, а не «потом закроем»; — если не знаешь, как что-то сделать технически, это не повод не браться: можно разобраться с ИИ, главное проверить результат. Сейчас ищу работу бизнес-аналитиком (junior). Если у вас документация до сих пор живёт в Word и это мешает, мне есть что рассказать. #docsascode #документация #бизнесаналитик #техническийписатель #Markdown