tighten up documentation
Merge pull request #44 from mozilla/documentation-update

tighten up documentation