improve readme and docs [ci skip]
Merge pull request #448 from d10/master

Improve readme and docs. [ci skip]