doc: corrections while reading it
Merge pull request #332 from blueyed/develop

doc: corrections while reading it