A few amends to the documentation

Having skimmed through the documentation, I found a few typos that I felt like correcting.

I took some liberties on the way. Feel free to comment and ask for changes.