Extend and fix documentation
Some parts of the documentation were not referenced properly. Since we ran
sphinx twice and one time without warnings as error treatment these warnings got unnoticed. This hack was necessary due to a new sphinx version. However, it seems like we don`t need it anymore.
Furthermore, the documentation is extended a little bit and corrected in some parts.