А можно ссылку на какое-то одно решение и документацию как им пользоваться? Что я хочу: возможность конструировать сайт приблизительно как в Тильде, но хранить его в гите. Желательно опен сорс решение.

Gatsby например

В Гэтсби нет конструктора а-ля Тильда

Но честно, мне лично его hot reload вполне заменяет потребность в конструкторе: поменял местами теги в JSX и радуешься

Ещё из мира React рекомендую рассмотреть preact-cli

Там есть хорошие бойлерплейты для генерации статического сайта, но всё это гораздо легковеснее Gatsby (даже с gatsby-plugin-react)

Hugo

А ссылку?

Коллеги, вопрос такой, использую Sphinx+RST, подключаю к каждому руководству (админу, пользователю и т.д) файл с глоссарием. Почему-то во всех наших руководствах, глоссарий, имеет нумерацию 5, хотя стоит в самом конце (см. фото). Как это лечить?

Привет.
Коллеги задайте пожалуйста направление поиска по следующей проблеме. Есть под сотню самописных приложений для автоматизации процессов компании. Встал остро вопрос документирования коммуникаций между приложениями и потоков данных между ними. Требуется ответы на вопросы: список интерфейсов, для каждого интерфейса: кто его пользует, какую основную сущность интерфейс представляет. Т.е. хотелось бы видеть что-то вроде:
 
Система: А
Интерфейс: PayAdvanceByUserPerPeriod
Подписанные системы: B, C, D
Сущность: Advance Payment

У нас есть идея каким-то образом скрестить свагер с тем что каждая система знает кто имеет доступ к каждой API (по Active Directory логину системы). А потом еще накатать скрипт который в PlantUML будет рисовать схемы по парам система-сущность
Вдруг есть готовые инструменты/скрипты? Или какие-то практики которые в принципе не советуют так делать? Или делать по другому?

Последнее, что я слышал на эту тему — доклад Михаила https://events.yandex.ru/events/giperbaton-04-12-2019?openTalkVideo=222-653 Но не знаю, чем кончилась эта история (или не кончилась) и о наличии аналогичных инструментов

всё в порядке, сдались.

Спасибо. Интересно.

По качеству документации Asciidoc получился вот такой пост на Хабре https://habr.com/ru/post/571326/

Вылечил, если кому интересно, то просто теперь инклюдом подключаю в конце последней главы глоссарий и все ок, раньше подключал в оглавлении. Интересно, а как можно исключать термины  для документов, в которых они не встречаются? Это можно сделать?

Очень крутой обзор, спасибо вам большое!

Мне интересно! Спасибо!

🙏

В одной маленькой психиатрической больнице к каждому из под сотню сделанных документов первым замечанием было "Привести в соответствие список терминов". В Asciidoctor через docbook и xpath (примеры привёл выше) можно с умеренным уровнем приседаний на падежах проверять, что перечень терминов соответствует тексту.

Ну все, первый mr от юриста.


Мастер копии договоров теперь живут в гите и редактируются там

А как вы отловите левые термины?