What is the documentation workflow

[fretchen]

We are testing the generation of documentation from markdown files and keep wondering about appropiate frameworks. We currently consider:

• jekyll, however first tests are not super convincing.
• docusaurus someone mentionned that you guys might be using it.
• jupyterbook Kind of works nicely for documentation...

Do you have any suggestions there ?

[georgimld]

We are using docusaurus and we are quite happy with it. You can check our trubudget-website repo to see how we implemented it. Basically the documentation that we publish in the Trubudget docsfolder is automatically published on our website using docusaurus when we publish a release. Hope this helps and the answer is not too late!

[fretchen]

Thanks. We had actually started to use mkdocs-material in the meantime in two repos. It works quite nicely in the open-geodata-model and the d4dtools .