Upgrade documentation from a README

[raphaelcherney]

There exist some dedicated solutions that can lead to a more polished documentation sites (e.g. the Create 3 docs used Material for MkDocs). Consider upgrading. We can still host with GitHub Pages for simplicity.