fixed or clarified parts of the documentation
Merge pull request #5 from dominikschnitzer/doc-fixes

Minor documentation fixes/clarifications