navis
navis copied to clipboard
Switch documentation to mkdocs + mkdocs material
This is a pain in the neck but I think migrating to mkdocs
would pay off in the long run:
- The build process is so much smoother and faster than Sphinx + RTD (live preview!)
- Much more modern look and feel
- API documentation (via
mkdocstrings
) is just incredible - Markdown instead of freaking RST
and the lost goes on....
As an example, check out the docs for Octarine I cobbled together over a weekend.