Confluence это инструмент для написания доков, базы знаний. Он также, как и трелло, и жирка – один из продуктов атлассиана. К маркдауну, правда, вряд ли имеет большое отношение. Конфлюенс он не совсем про docs as code. Просто текст (может более опытные товарищи меня поправят)

Конфлюенс это грубо говоря гугл докс. Коллективная папка с текстовыми документами.

Есди еще правильнее говорить - то это вики.

судя по описанию такое если и можно использовать для создания базы знаний - то скорое какой-то внутренней, не внешней.

Какой инструмент удобнее для docs as code? я так понимаю используют подход такой - потому что легче подключать разные плагины и обновлять такую документацию.
вот первые шаги от обычного HTML  документа

Gitlab+pandoc+локал хост какой-то

Ну, про легче — это интересный вопрос)

Docs as code, как мне кажется, это не совсем про легче. Но это удобно в плане поддержания актуальности и версионности документации

Сходите к Тому Джонсону, там есть масса материалов по Вашему вопросу.
https://idratherbewriting.com

Например,

https://idratherbewriting.com/blog/recommended-docs-as-code-tooling-setup/

Или заходите ко мне: https://starkovden.github.io/Doc-as-code-tools.html
Здесь перевод курса Тома Джонсона

Простым языком конфлюенс это недоработанная софтина которая внутри организации помогает на коленке организовать что-то вроде интранет портала. В базовом функционале позволяет решить какой-то узкий спектр задач. За фентифлюшками следует идти прямиком в магазин приложений Atlassian Marketplace. Перед установкой фентифлюшек, в надежде что они оправдают ваши потребности, настоятельно рекомендуется проследовать на страницу техподдержки конкретной фентифлюшки. Проследовать и понять насколько фентифлюшка крива и недоработана

да вы только посмотрите, чего делают с этой недоработанной софтиной на коленке
https://www.youtube.com/watch?v=wxDMSi1LJHw
https://www.youtube.com/watch?v=e25Ntupubl8

Премного благодарен ! Но без напилинга не обойтись в любом случае

docs as doc тоже без напильника не будет работать, к сожалению

я бы все же не обобщал — у меня были успешные опыты настройки Confluence в командах на 10-30 человек вообще без плагинов и напильника, либо с 1-2 плагинами, которые сразу встали и кушать не просили

сильно зависит от специфичности хотелок и низлежащих бизнес-процессов

кажется (но это мое субъективное, не подтвержденное опытом мнение), что проблемы начинаются тогда, когда Confluence пытаются натянуть на набор требований, который принципиально не реализуется вики-системой.

Окей. Возможно всё зависит от конкретной задачи и возможностей функционала соответственно. Я поковыряться с экспортом доков при помощи Sroll Word плагина. Жаль что не могёт конфа в ГОСТ. Могла бы-цены б ей не было

Вот прям в точку попали