Fix documentation build

Mayr, Hannesrequested to merge
105-make-sphinx-and-readme-compatible into dev

Fix warnings that occur when building the documentation with sphinx.

Closes #105 (closed)

Merge request reports