Bugfix/#183 refine documentation

Closes #183 

For review by @smangelsdorf