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.