Migrate to Mkdocs

[enjeck]

The current theme doesn't provide a table of contents, search or versioning for the docs. Mkdocs provides this for us. This PR migrates to Mkdocs, and hopefuly, the set up is correct for deploying to GitHub pages. In a follow up PR, I'll add support for versioned docs

This is what it looks like:

[dromer]

Hey thanks a lot! I've been thinking about how we could add better docs hosting.
Mkdocs also came on my radar recently, but I had not played with it yet.

Adding ToC, dark/light and versioned docs are all super nice and exactly what we need! :)

I'll need to try these builds locally (also something I was never able to reproduce with jekyll) first to be able to get into review.

[dromer]

First off: do you mind changing the deleted files into renames in the history? :)

[enjeck]

I'll need to try these builds locally (also something I was never able to reproduce with jekyll) first to be able to get into review.

After installing dependencies, mkdocs serve should do it

[enjeck]

First off: do you mind changing the deleted files into renames in the history? :)

Uh, how do you mean? It there a git command?

[dromer]

git mv <old_path> <new_path>

This way file history stays intact instead of recreating the files. Somehow it happened only on these two files as far as I can see.

[dromer]

We should cleanup _config.yml as that was for the jekyll setup.

Also we can add the CONTRIBUTING.md and CODE_OF_CONDUCT.md as well.

[enjeck]

git mv <old_path> <new_path>

This way file history stays intact instead of recreating the files. Somehow it happened only on these two files as far as I can see.

Sorry, I can't figure out how to cleanly do this without messing up the commits 😭

[dromer]

It's ok, there were not that many changes on these files anyway :)