Great work kamailio devs in releasing 6.0.2 and the continuing work on master branch.
Wishing you a restful weekend and while you are at it, here are some ideas, probably half-baked, for your consideration.
Background:
Kamailio uses XML for documentation that is followed by an automatic task that renders to plaintext(README file) for the repo and HTML for the website
Proposal - Use Markdown for docs/
Author docs/ in Markdown - no rendering in-repo - website will need a static site generator that can create the internal links
Benefits - markdown is a common mark-up tool for plaintext that has sufficient semantic richness for kamailio - most developers are familiar with markdown especially from Github, other git-forges - avoids the in-repo rendering step - most git-forges can render the markdown file on-screen so that there is less iteration required if there are typos in xml. It is also easier for the developer to validate their docs prior to pushing to master branch
Work Required: - evaluate and implement the static site generator - the in-repo README generator can be slowly phased out
Regards Richard (Shih-Ping)