Restructure and add more details to documentation

Jakob Moserrequested to merge
docs/improve-docs into master

Merge request reports