Why Antora for the documentation ?

Antora allows us to manage our documentation as code, which allow us to build our website the same way as we would build a software, store the code in a version control system and build/publish our documentation website using the same CI/CD principles as used for our softwares or our infrastructures.

Asciidoc is a lightweight markup language, similar to Markdown but offers more possibilites and more flexibility. It is higly configurable and allows to write documentation, articles, web pages, etc.

The website for our documentation can be automatically built and published on Github Pages using Github Actions.

The appearance of the website is externalized in an independant project and packaged as UI bundle. It can be highly adapted to ones needs and be can reused over multiple documentation projects.