Видишь, я нашёл, как расшифровывается твой любимый rst, теперь твоя очередь

Можно вообще не собирать доки, а рендерить онлайн с помощью https://asciidoctor.org/docs/asciidoctor.js/

даже при рендеринге онлайн собирать всё равно нужно, иначе нарушение разметки будет сразу ломать документацию

мы держали доки в отдельной репе. При релизе CI генериn набор html и выкладывает на nginx как статичный сайт. техписы смотрят как будет рендериться во время создания доки сами у себя в локальных компах, кто в vscode, кто в asciidocFX. Я лично использую расширение Хрома Asciidoctor.js Preview.

А я из вс_кода смотрю )

В вскод площадь окна жалко на предпросмотр тратить. На 14 дюймовом экране проще переключиться на хром.

ctrl+alt+s == билд html-страницы

#вопрос
@Nick_Volynkin , доброго дня! Порекомендуйте пожалуйста статью или доклад, где описаны варианты хранения и сборки документации для многорепозитарных систем. Проблема в следующем: у текущего работодателя очень большой зоопарк по количеству репозитариев и стеков. Хранят исходники в гитлабе (несколько отдельных хранилищ с разными адресами) и битбакете. Стек очень разнообразный: .net, Java, Kotlin, Swift. Конечное решение представляет из себя набор фронтовых клиентов, монолитных приложений, микросервисов (причем написанных на разном стеке в т.ч.).

Например, в стеке Javа уже сделаны некоторые попытки сделать документацию на ASCIIDoctor + Spring RestDocs. В других стека ситуация похуже.

Т.е. на первом этапе хотелось бы определиться с местом хранения документации по интеграционным решениям и определить способ сборки общей документации по множеству репозитариев.

Привет, я попозже смогу ответить )

аскидок + антора.
В анторе пилишь пайплайн по сбору док из разных реп.
Я бы даже написал, что антора заточена под мультирепы.

а как реализовать сборку Spring RestDocs, если они лежат в другом репозитарии? Просто джобой собирать в отдельный контейнер?

скорее отказаться от спингра.
Антора сам по себе веб-генератор. Внутри анторы есть пайплайн, в котором прописывается ci

А какой плагин это позволяет делать?

ctrl+alt+s
ну и само собой
asciidoctor.asciidoctor-vscode

а, у меня reStructuredText :( локально собираю каждый раз

я думаю и в rst есть средство, чтобы не билдить каждый раз.
я год назад кстати смотрел видео на ютубе, где поднимался сервер на node.js и все изменения в коде были видны онлайн на странице.
Ссылку на видео не просите, сам найти не могу (

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

У нас в Тарантуле такое есть, там внутри sphinx-autobuild

А есть кто с keycloak работает?

мы работали, но не сказать чтоб большие гуру в нем.  Как openID Connect работает.  Gatekeeper сейчас лучше уже не использовать