Gitjournal не смотрел?

а можно ссыль на эту Подлодку, если несложно?

https://podlodka.io/197

Правда я там накосячил со звуком, поэтому голос как из бочки

котегоричски блогодорю!

Ох, как шикарно! Спасибо большое!

+

Что касается инструментов для организации мыслей, то здесь, на мой взгляд, гораздо бОльшее значение имеет навык организации мыслей, а не инструмент. Использую Google Keep и Notion.

бесит notion, нет даже  недельного среза offline + future sync, тут как не организовывай, вне сети фиг тебе,  а значит полная фигня

А если вы считаете что норм 24/7 online ну удачи вам, лет через 25 за упокой на могилке выпьем

Всем привет! Кто-нибудь по ГОСТ в sphinx или foliant разрабатывает доки? Можете шаблончиком поделиться?

Вылил боль в хабр https://habr.com/ru/post/550086/ . Не всю, конечно

Ребята привет. Нужен совет.
Контекст
Есть веб приложение (довольно сложный инструмент).
Внутри справка.
Сейчас эта справка лежит вместе с кодом приложения в виде asciidoc.
Собирается при сборке приложения.

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

Варианты
Можно оставить как есть, что не очень удобно, т.к. смешивается код и дока.
Можно вынести в отдельный репозиторий. Но тогда вопрос: как хранить сгенерированную доку (либо покаывать отдельным static ресурсом, либо встраивать копированием в приложение).

Как обычно делают?

Приложения можно собирать из разных репозиториев же?

Конечно

Ну так выносите и собирайте. В чем вопрос?

по идее, тогда должно быть три репозитория: код (собирает свои артефакты), дока (свои) и сборщик, который содержит один файлик с набором версий того и другого. И именно вот этот последний репозиторий выдает всё в сборке

Наконец нашёл, как расшифровывается rst. Это же транслит со славянского Рьцы Слово Тврьдо, т.е. "говори речь уверенно". reStructuredText — это потом придумали

Как другие делают интересно.

Просто вы не написали свой стек совершенно. На чем приложение, чем собираете его, что за VCS. Варианты такие:
- вроде у всех систем контроля версий есть концепция, аналогичная svn:externals, позволяющая замапить один репозиторий в другой
- как написали выше: можно иметь разные проекты под разные модули и отдельный со сборщиком
- но вроде не должно быть проблем сделать так, чтобы ваш текущий билд скрипт собирал хелп не из основного репозитория приложения, а из отдельного

А что с аскидоком, профессор?