rss twitter gitlab github linkedin linkedin instagram
Gitlab Tip: Generating documentation with mermaid
Aug 04, 2019

One best practice we follow regarding documentation is to keep it close to what it describes, we prefer including those files together with the actual code, in a different docs/ folder. We write them in Markdown because it is a simple and easy to understand format that is automatically rendered correctly when browsing those files in Gitlab.

And because we are Gitlab users, we are also able to use other features like Gitlab pages and the mermaid support in markdown to generate even better and useful documentation.

Using mkdocs for generating public documentation

There is Gitlab repository that demonstrates this process, important bits about this specific repository are:

The final result:

The more you know

Back to posts