Да-да. Я сколько JB просил такое сделать, но увы.

А ещё отладка сборки документа (с include, условиями включения и так далее)

Это само собой. Md с инклудами не очень. Во фронте php питоном там можно решить вопрос, для согласующих. А у исполнителей только в самой ide.

Ну, надстройкой над MD или чем-то ещё.

>ну и консоль
Совет уровня DocOps) спасибо!

Я хочу что-то вроде git annotate, но не про коммиты, а про комменты на собранном документе

А комменты во фронте собирать? Ну обычно они там нужны. Но и в ide тоже нужны, но больше уже от других сотрудников.

Оно есть у вас в доке или вообще?

А комментарии к пулл-реквесту вы где читаете?

Комменты кода, и от народа кода, совсем не то, что нужно в кейсе дока с комментами от сторон.

То есть вы хотите видеть собранную доку прямо в ИДЕ и комментарии к ней? Или вы хотите, чтобы в доке можно было оставлять комменты, а они добавлялись в код? Тогда их можно было бы вставлять в виде TODO, для которого есть отдельное окно, где они перечислены

Мне хочется видеть и комментировать и в IDE и на артефакте типа веба...

Типа собрал, выложил для клиента, собрал комментарии, сделал патч и пересобрал

>вывод облако тегов и саязей, вызов ссылаемого тега
Тэгов? Мы про мд?

>связи нужны как отдельное окно
Ссылки? Недостаточно будет того, что можно на любую ссылку кликнуть и она откроет то место, куда ссылается? Вам нужно всю паутину видеть?

>диаграмма как код нужна
mermaid?

А например отдельный визард для джекил проекта с поддержкой конфигов и ликвида, со своей настраиваемой ран конфигурацией? Код ассистанс, комплишен, навигация, рефакторинги, инспекции, интеншены (ту же таблицу сделать) или вообще редактор таблиц (боль мд)?

Я хочу напротив строки (как git annotate) или поверх текста исходника (как Word/Google Docs) видеть комменты, которые прилетали бы из собранной доки

думаем завести

Лень про все писать по строчно. Отвечу в общем - то что есть недостаточно, иногда убого. Иногда оторвано от остального.

Да, md (а может и не его) в общем как вариант раширить средствамии yaml, и строить свою модель информации дока и модель доков проекта.

Мне же не только док и его строчка нужны, а сколько работа с информацией внутри него. С командой, от владельца до исполнителя. Ну и сам док контролировать так же. И доки проекта. Все три слоя, да еще и во времени. Например есть требования, внутри дока, мне требования как объект нужны. Но через ДОК. В общем все сложно, и просто. Посмотрите как должны работать проектироващики под заказ с чертежами до уровня объектов в них. Вот примерно это, но строчками и объектами ИТ в доках, от требований и схем до Кода.

Вроде ж уже? Интеграция VSCode и GitHub это делает?

Выше контекст, мы про комментарий к уже собранной доке

М, понял. Т. е. там ещё через какой-то source map нужно пропустить...