Пока не знаю, но возможно будут

По задаче, хочу интегрировать процесс документирования, в текущий процесс разработки ПО

Во, это важно. Нужен ли там сложный контент внутри (как блоки кода или списки), нужно ли объединение ячеек.

Списки точно будут. С таблицами сложнее, пока неизвестно, но не хотелось бы испытывать сложностей с ними

да, еще будут схемы, которые рисуют аналитики и архитекторы, вот это тоже важно при выборе, должна быть возможность хранить не картинки, а редактировать их. смотрю на  plantUML + markdown

mermaid.js можно в docusaurus встроить есличо

ни то, ни другое еще не использовал, посмотрю, спасибо!

докузавр берите второй, если захотите с ним связаться)

#вопрос

У меня на текущем проекте существует около 35 микросервисов разной степени упоротости. Причем ни в одном из них не применяется кодогенерация на Swagger, в лучшем случае есть Spring REST Docs простой с кучей тестов и то не во всех. Прям боль боль.
Встречались ли в практике какие-либо шаблоны репозитариев или плагины, которые бы сравнительно быстро позволили перевести весь этот колхоз на кодогенерацию со Swagger? Потому что ручками переводить врядли получится убедить команды.

Как варик посоветовали попробовать развесить аннотации на код и запустить springfox. Отзовитесь, кто пользовал пожалуйста.

😄👌хорошо

Да, я писал, мы этим пользуемся. Разработчики сами инициировали (редкий случай). Единственное, я немного ругался, когда json-файл не соответствовал Open API (по факту часто оказывалось, что из-за ошибок в коде).

сейчас поищу выше по чату

там где-то совсем высоко))

собственно ругался-то я потому, что когда готовил документацию заказчику, процессор в Asciidoc ругался, что не может обработать исходный файл... так-то вообще бы молчал

Посмотрел asciidoc, интересно, без плясок  сгенерировал несколько форматов документов  Подскажи с таблицами там проблем нет? Схемами? Например, plantuml поддерживает, чтобы можно было править сразу в коде? Может какие то свои  решения для схем есть?

Plantuml отлично эмбеддится. Также можно встраивать схемы drawio в виде png

Первый рендерится через кроки (kroki)

О, спасибо, png не подходит, надо чтобы аналитики сразу могли править

есть где поглядеть?