Всем привет. Помогите, пожалуйста, с проблемой. Я только начинаю разбираться в инструментах и столкнулась с тем, что Read the Docs не собирает сайты с невстроенными темами. У меня всегда выходит ошибка: "no theme named 'sphinx_material' found (missing theme.conf?)" При этом тема установлена,  theme.conf есть. В файле conf.py все прописано, так как сказано в ридми к конкретной теме (пробовала несколько разных). Например, для темы sphinx_material: html_theme = 'sphinx_material'
html_theme_path = ['c:\Program Files\Python38\Lib\site-packages\sphinx_material\sphinx_material'] Читала на разных форумах, как справиться - но ничего не помогает. Заранее спасибо и извините за глупые вопросы.

да у нас внутренняя поделка. и там генерация только от части.

модель данных мы руками пишем, генерируется код самих контроллеров. не совсем тоже что и vaadin.

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

conf.py, кажется, не надо полный путь писать.
В разделе Path setup  
import sphinx_rtd_theme
В extensions
extensions = ['sphinx_rtd_theme', ]
И в раздел html_theme = ''sphinx_rtd_theme'

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

не надо писать контроллеры и кодогенерировать. Мне нравится. Конечно погуглю, но посоветуйте толковую статью про опыт применения vaadin.🙏🏻

Коллега сделал такой бойлер-плейт проект, включая пирамиду тестирования. Сборка, правда не на GH Actions, а на Jenkins, но разница небольшая. https://github.com/inponomarev/vaadin-celesta-springboot-template

Коллеги, а кто может подсказать по опыту, для техдокументации что лучше выбрать rst или markdown?

По опыту хорошо заходит asciidoc

Спасибо, посмотрю.

Это очень субъективно. И ещё есть asciidoc, ага. И для markdown очень много разных инструментов.

Вообще меня слегка пугает то, что все эти языки они про разметку вместо структуры

Те вытащить из документа «такое то описание такой-то фичи» нетривиально

Кстати, да. Тут проскакивал бойлерплейт с хорошей структурой.

Со всей цепочкой требований, описаниями api и тестами… о да

Вот о наличии подводных камней и хотелось бы услышать)

Расскажи подробнее, какую задачу решаешь. Какие выходные форматы нужны, какие к ним требования? Нужно ли документировать код? Генерировать документацию прямо из кода? Переводить доки?

Есть ли большие и сложные таблицы? ;D

Word и pdf по Гост, сайт, api, javadoc,перевод пока не нужен. Плюс "поженить" это с конфлюенс и джирой