Useful conversation to inform our decision to use mkdocs: encode/httpx#1220

It looks like they stuck with mkdocs in the end.

I created a draft of the new docs structure using mkdocs. Used django-idom docs as the initial template.

https://github.com/Archmonger/idom-docs

Currently, the only thing that has been developed is the navigation names, and website theme.

Can be previewed by typing the following:

pip install -r build-docs.txt
mkdocs serve

Looking at the docs for Textual (a popular terminal UI framework) I found a list of mkdocs plugins and extensions we might want to consider using.

mktestdocs also looks interesting.