Hi, The only info that I have been able to find about the migration process to AsciiDoc is part of the contributing web page
"Most of the documentation is stored on the wiki. We are currently moving the documentation into the code (AsciiDoc). From there it is automatically converted to the wiki. So before editing the wiki check the code because otherwise your changes may be lost. This transition is work-in-progress." Do we have more info about that (jira tickets, ...) ? Is it described somewhere how the HTML content is generated ? Do we use asciidoctor to render the HTML document ? If this is the case, then we should mention a link to the asciidoctor web page (user manual, writer manual) and also indicate that we can use the asciidoctor syntax extending what is proposed by asciidoc Regards, -- Charles Moulliard Apache Committer & PMC / Architect @RedHat Twitter : @cmoulliard | Blog : http://cmoulliard.github.io