Documentation reviewed

A start on issue #4.