Find a replacement for MkDocs.

[sadiepowell]

Unfortunately it seems like MkDocs 1.x is abandoned and 2.x won't support extensions so we need to find a replacement.

• https://fpgmaas.com/blog/collapse-of-mkdocs/
• Version 2 mkdocs/mkdocs#4077
• https://squidfunk.github.io/mkdocs-material/blog/2026/02/18/mkdocs-2.0/

There appears to be a community fork but I'm uncertain how maintained it is given the last commit was two months ago.

• https://github.com/properdocs/

The current site builds fine and there's not really any issues but we should find something to migrate to.

Features we need:

• Ability to have custom plugins so we can keep generating the docs from YAML.
• Ability to pages as if they are templates (like we do with Jinja2 in .md files currently)auto
• Support for admonitions and other Markdown extensions.

I'm wondering if we should just go back to Jekyll to be honest.