update documentation

- fix few typos 
- corrects some odd sentences