Azure Devops WIKI and MKDOCS - How to create a excellent navigation?

[Dirk-michiels]

We are using Microsoft Azure Devops Wiki for our product documentation. This allows us to created Mark Down Files very easily. The MD-files also have a hierarchical relationship. We are though struggling in setting up the left side menu structure / navigation in the site created by MKDOCS.

The structure we have in mind is something like [this ](https://microsoft.github.io/code-with-engineering-playbook/documentation/recipes/static-website-with-mkdocs/) We can create this in Azure Develop WIKI and you can navigate it there, but we can not get MKDOCS to create the same navigation structure. The ordering (.Ordering is there) is not there any more and apparently H1 in the MD files are used as document titles in the menu. We are clearly missing out on something.

We think we can add the structure in the MKDOCS YML file but this this a painstaking process with many file and hope this is not necessary.

Is there a good resource on how to do this?

All pointers - very much appreciated.

Best Regards

Dirk

Here is our setup:-

• the Mkdoc.yml file

- the structure in Azure Devops

- Repo Files

• The MKDocs output

[squidfunk]

Good question, I'm not proficient in Azure. Maybe the mkdocs-awesome-pages-plugin can help?

[jromal]

Why you just do not create a repository for the documentation? And do not use DevOps Wiki?