Fix the docs in several places (#33)

general improvements ✨

Uses more features from Material for MkDocs

improves the README file, and index.md

transfers the documentation to GH