Fixed some typo and inaccuracies in the documentation

Sorry for the previous pull request. I'm used to commit every consistent change.

Hope that a commit per file is OK.


Best, Martin