Начат перенос документации на систему AsciiDoctor.
Прототип публикуется здесь:
http://www.bgcrm.ru/doc/3.0/manual/ автоматически при изменении в GitLab.
Основные цели миграции:
[list=]
[*] хранение исходных фалов документации совместно с исходными кодами;
[*] гибкость и расширяемость, возможность инклудов, препроцессинга и т.п.;
[*] контроль целостности ссылок;
[*] простой и лёгкий публикуемый формат в виде набора HTML файлов и ресурсов.
[/list]
Примеры руководств в данном формате:
https://asciidoctor.org/docs/user-manualhttps://docs.gradle.org/current/userguide/userguide.htmlЗамечания и пожелания приветствуются.