move to mkdocs

[dholbach]

Following some of our other projects, looking at mkdocs for wksctl too.

To test it, run

pip3 install -r docs/requirements.txt
mkdocs serve

I can point http://wksctl.rtfd.io/ to use this branch for testing too.

[dholbach]

Suggested new docs are: https://test-wksctl.readthedocs.io/

[fbarl]

Thanks for this PR @dholbach, visually it's a great improvement IMO! 🎉

I went through the code as well and put a couple of small comments. I'll approve but please address the comments and try to get @bia's stamp as well before merging :)

[bia]

Looks great! Thanks @dholbach!

What do you guys think about making the navbar white to match eksctl?

[dholbach]

I personally feel the all-white is a bit dull. Could we use other colours that make sense? What does everybody else think?

[dholbach]

I stole the navbar colours and made a variation of it after reading https://github.com/openfaas/docs/blob/master/mkdocs.yml and https://github.com/openfaas/docs/blob/master/docs/stylesheets/extra.css

[bia]

Your version is more beautiful. Let's just keep it unchanged and merge. :)

[jrryjcksn]

Very nice! A big improvement.

[dholbach]

Yes. Let's do any clean up and beautification in a new PR. Thanks for the reviews @bia and @fbarl ! <3

[dholbach]

I deleted test-wksctl.rtfd.io.