trying to describe what its all about

- fixed some typos
- trying to improve readability