общество самит

Docs-as-code на максималках. Часть 2: Пайплайн Markdown → Confluence

Цикл "Docs-as-code на максималках": Фундамент: Архитектура и видение проекта Публикация: Пайплайн Markdown → Confluence ← вы здесь Рабочее место: Obsidian как IDE для аналитика Правила игры: Workflow и обратная совместимость AI-агент: На пути к вайбаналитингу В прошлой части мы договорились о распределении ответственности: Git - мастер-система для хранения документации, Confluence - витрина для чтения.

Теперь собираем движок, который перенесет md-файлы в страницы Confluence.На первый взгляд интеграция выглядит простой: аналитик пушит .md в репозиторий и страница сама появляется в Confluence, без дополнительных приседаний.Между этими двумя точками стоит CI-пайплайн, который:поднимает окружение с Node.jsнаходит все добавленные/измененные md-файлырендерит их в нативный ADF-формат Confluenceпубликует через Confluence APIПроставляет ограничения на редактирование созданных страницЗвучит просто, но дьявол, как обычно, в деталях.Ремарка: поиск производился в начале 2024го года, возможно за это время появились какие-нибудь новые качественные проекты.

DMCA