Update, extend and finish documentation

[erdlet]

We still have a lot of empty documentation pages which should be filled before the 3.0.0 release and added to the gh-pages.