update and better docs
Merge pull request #1 from paulohp/master

better docs