Small doc fixes

I fixed a couple of typos and improved a bit the formatting and the grammar.