Point to the documentation from the top of the README

[tmadlener]

BEGINRELEASENOTES

• Make the README point to the documentation instead of the markdown files

ENDRELEASENOTES

@m-fila should I keep the links to the markdown files? Or are you happy with where the link takes you?

[m-fila]

Thank you Thomas. I remembered you set-up a nice documentation with sphinx, but I couldn't find a link to it, hence my request. I think it's very visible now.
The links to markdown can go I think

For extra swag and visual presence we might also slap a badge 😉

[tmadlener]

Swag is always good ;) Thanks for the pointer.