update README and docs
Merge pull request #84 from ndawe/master

[MRG] update README and docs