clarifications/typo fixes/improved sample code
Merge pull request #42 from fhocutt/doc-improve

clarifications/typo fixes/improved sample code