Rather than using mkdocs - the site documentation could use [sphinx](https://www.sphinx-doc.org/en/master/) the would allow easier site navigation generation and an easier integration with https://github.com/ivoa/IvoaDocViewSite