Documentation

[benedikt-voelkel]

As a first approach here we could think about extending the README.
To be discussed if we would like to have a documentation page eventually.

• extend README
• review all doc strings
• create a documentation page (simply based on the doc strings as much as possible)
• include "how to use as a library"