Issue tracker'ы, вроде YouTrack или JIRA так при изменении проекта у выбранной задачи оставляют связь в идентификаторах задач, что PROJ_X-12 это PROJ_Y-3
Слово "программирование" звучит как-то страшновато. Но это в худшем случае несколько десятков строчек кода. Причем, в основном, шаблонизатора. Пытался это показать в статье, возможно не очень получилось. Тут скорее проблемы будут в организационной части, как организована сама разработка
появилась идея как сделать то что мне нужно. Относительные ссылки относительно текущего документа забудем как класс. Будем строить абсолютные ссылки, но выдглядеть они будут как относительные относительно некоего module root . например /processes/a-process/index.adoc, /services/someservice/index.adoc сам module root будет выставляться средой рендеринга/сборки как переменная в asciidoctor