better usage introduction
method comments
Merge pull request #2 from pezra/better-readme

Better docs