Rework the documentation

[oliverklee]

After reading this blog article, I think we should rework our documentation: https://www.divio.com/en/blog/documentation/

And this article about good READMEs: https://dbader.org/blog/write-a-great-readme-for-your-github-project