rephrasing based on guitarman@ comments
fix typos
Merge pull request #299 from maslinych/feature/docs

rephrasing based on guitarman@ comments