Update README

- corrected few typos
- improves consistency on examples
- adds some suggestions to improve readability