Many documentation fixes

This includes:
* Symfony Documentation Standards
* Typo fixes
* Improvements of the style
Removed trailing whitespace
Merge pull request #145 from WouterJ/standards

Fixing Documentation "Book" section