bug 858244 - documentation for public api

(LET ME REBASE FIRST)

Anybody working on socorro-crashstats, r?