Update README

- corrected few typos
- improves consistency on examples
- adds some suggestions to improve readability
Merge pull request #1 from maasg/patch-1

Update README