revising / updating docs
start restubbing README
Merge pull request #22 from mozilla/improve-docs

Documentation improvements