Review of documentation.

Additional feedback is given via pen & paper.

See Github Issue #83.

Signed-off-by: Angelika Tobisch <tobisch@dresearch-fe.de>