updating docs
Merge pull request #315 from mozilla/api-doc-update

updating docs