Skip to content

How to add documentation

How to enrich the documentation

We are using mkdocs to generate our documentation. the purpose is to automate as much as possible the job and to deploy it automatically to GitHub.

Mkdocs documentation can be found here

In a nutshell

  • Add any new pages in the yml file mkdocs.yml located at the project root folder
  • All pages are written in markdown described here
  • To build documentation and access logs for warnings and errors, you can execute mkdocs build
  • To generate the documentation, execute the following command mkdocs gh-deploy

Info

  • gh-deploy might fail pushing the result to github pages, it can be solved by
  • pushing the branch gh-pages yourself.