Review of revised documentation.

This completes my review of the revised documentation.

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