А в чем пишете?

VS code

Поставил плагины, настроил студио. Проблем совсем нет

Ок, спасибо!

Более того, я использую gradle для сборки docx из adocб где в качестве submodule подключен doctoolchain

На всякий случай: для VS Code есть расширение "Remote – WSL", открывающее редактор так, будто он размещён внутри этой системы.

Нужно только обращать внимание на пути. При активной работе всякие преобразователи лучше запускать на файлах, размещённых в линуксовой файловой системе (т. е. не /mnt/c/Users/…, а /home/…, можно спросить у команды pwd, где вы).
А то при прямой обработке файлов на виндовых томах случаются всяческие спецэффекты вроде необнаружения изменившихся файлов.
Это не такое уж неудобство, поскольку Проводником можно без проблем залезть и туда (выполнив в нужной папке в командной строке explorer.exe . [с точкой, да] – да, в WSL так можно).

Коллеги, а нет ли у кого на примете статьи по общей организации доки с использованием asciidoc? Хочу понять, каковы best practices при создании объемных мануалов. Пока на ум приходит только сделать корневой adoc, в который уже вставлять инклюды с разделами. Но я подозреваю, что кто-то уже делал подобное гораздо более элегантным способом.

Надо взять antora и ее гайдлайн

Посмотрю, спасибо!

Антору надо посмотреть обязательно. Там хорошо сделан препроцессор URI.  Но есть еще хитрость, которую часто использую с Asciidoctor. Вставляемый текст в каждом файле можно тэгировать. Это позволит собирать как разделы по отдельности, так и документ, объединящий разделы.

Философия 42
https://arc42.org/

Я тут зарегался на GetMentor. Гляньте, пожалуйста, всё ли понятно, что можно добавить: https://getmentor.dev/mentor/nikolay-volynkin-186

Привет! А с организациями работаешь?

Работаю всё равно с конкретными людьми, но договор может быть с организацией, почему нет )

Пиши в личку детали )

Эх, жаль, не могу как на Юуду, оставить отзыв: "Рекомендую, учит, помогает!" :)

+ то же самое хочу сказать про Колю

Поздравляю :)

Здорово!!!

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