Small doc fixes

I fixed a couple of typos and improved a bit the formatting and the grammar.
Merge pull request #2 from bbatsov/patch-1

Small doc fixes