Some language improvements in the docs
Merge pull request #33 from andreif/patch-1

Some typos in the docs