Write proper documentation

A lot of the documentation comes from a template so is not ideal. The Reference section is now okay, as it is generated for currently existing sources automatically, but the rest is bad.

E.g. the development section heavily references github, that must be fixed.