Improvement suggestions for the documentation

Hi Bruno:
I edited the documentation a bit with some suggestions. Discard them if you don't like them. 
Good work documenting, buddy! :)