try a new doc generator

[meleu]

I'm tempted to change from mkdocs to docsify.

Also, use gitalk for comments.

[televandalist]

Docsify seems pretty neat. Would be a good opportunity to give the docs an overhaul, too. SIgn me up

[meleu]

Another approach I'm considering:

just-the-docs seems to be an extremely simple and useful jekyll theme we could use for a new documentation website.

Live Demo

Note: using a jekyll theme would solve the problem of the docs site being dependent only on me (bus factor = 1). I could enable a "github actions" to regenerate the website after every single commit (just like I did in the RANews repo).

[Sanaki]

My only major objection to docsify is that it requires npm to work with it locally, which is mildly vomit-inducing. That said, I believe the libretro docs use mkdocs and auto-publish just fine. Might be worth checking how they do that.

[meleu]

This one caught my attention recently: https://getdoks.org/

Besides the good design, another benefit is that it's hugo based (which means really neat support for multilingual content).