Is your feature request related to a problem? Please describe.
Currently, the user documentation is written in Markdown, which is fast to maintain, but strongly limited regarding layout and cross-referencing.
All other current ASAM projects using AsciiDoc based on a common guide. This leads to a harmonized view of all documents and a harmonized styling. And it resolves all limitations from Markdown.
Describe the solution you'd like
Translate current user manual/documentation in AsciiDoc
Development documentation of the framework itself should not be translated, because these files need to be easily accessible/readable in the repository
Use ASAM style templates
Setup the generation of the documentation in the CI
See ASAM Editorial Guide and other ASAM projects as reference.
Is your feature request related to a problem? Please describe.
Currently, the user documentation is written in Markdown, which is fast to maintain, but strongly limited regarding layout and cross-referencing.
All other current ASAM projects using AsciiDoc based on a common guide. This leads to a harmonized view of all documents and a harmonized styling. And it resolves all limitations from Markdown.
Describe the solution you'd like
See ASAM Editorial Guide and other ASAM projects as reference.