если в docx, то там не получится

тогда уже проще шелл или python скрипт написать

в gradle таск сделать

если быстро и в сфинксе нужен один док, то через sphinx-build -b singlehtml, как мне самой Николай подсказал пару недель назад

а там уже пандок

а в чем сложность с docx именно?

мне из rst в adoc надо)

https://stackoverflow.com/questions/10323317/batch-processing-pandoc-conversions

здесь люди в одну строку через find делают

спс!

exec не работает в батче при конвертации в docx

Documentation is Dead, Long Live Documentation!

На конференции GitLab было 2 доклада про документацию:
- Use Gitlab to Deliver "Docs-as-Code" Technical Documentation, который очень похож на доклад этого же автора на Write the Docs Australia.
- Documentation is Dead, Long Live Documentation!, который меня зацепил, потому что я люблю слушать про опыт создания документации от не технических писателей. Тут 2 докладчика, менеджер и разработчик, которые рассказывают свои впечатления от создания документации в Confluence и переезде на другую систему документирования.

Чем не нравится Confluence

- 90% времени уходит на оформление документации, а не на создание текста
- слишком много возможностей, часть из которых не нужна
- не работает поиск

Чего хотят

- чтобы было легко писать и публиковать документацию
- был базовый набор возможностей (как вставка изображения и ссылки) и продвинутый (как вставка примеров кода)
- можно пользоваться с Web или IDE
- хороший поиск
- обратная связь прямо в процессе работы над документом

Команда понимала, что они могут это сделать и с помощью Confluence, но слишком сложно.

Что используют сейчас

Попробовали VuePress, но потом переехали Material for MkDocs. Документация хостится на GitLab Pages. Из дополнительных фичей интегрировали в MkDocs draw.io. Счастливы:)

Доклад можно посмотреть на Youtube, для тех кто пропустил.

#намвсемнужнапомощь

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

но все равно грац: неплохой перевод текста в веб с версионированием уже отлично

У нас в гите и маркдауне хранится не только документация, но и базовые договора.

На днях выяснилось что у юриста в двух браузерах были разнын гуглологины и она отправила клиенту не тот договор, который согласовали внутри компании.

Теперь постараюсь вообще все договора перевести на гит-маркдаун процесс

О, это будет эпический подвиг )

Юристы маркдаун знают?

ну тут штука какая: пока они не отправили клиенту договор, который отличается от того, который согласован, у них было право на своё мнение и на «ой, не будем с этим разбираться, не мешайте работать».

А теперь будет как в том анекдоте про то, что «к овце я пристроился всего один раз». Нет, ребята, вы плохо работаете, шлете клиентам не те договора, поэтому теперь будет так.

В гитлабе довольно приятный Web IDE, будут пользоваться им

В рамочку и на стену :)

А есть возможность на базе docops делать достаточно сложные сайты, типа как тильда?

Да, и даже сложнее. Подробности есть на jamstack.org

Как-то там не очень подробно :)