bug 858244 - documentation for public api

(LET ME REBASE FIRST)

Anybody working on socorro-crashstats, r?

To get a sneak preview without having to fetch it down, here's a screenshot:
http://cl.ly/OZT8

And here's how it can look like if any of our models contains docstrings. 
http://cl.ly/OZap

Perhaps we should make a collaborative effort and sit down and work on some doc strings for all the interesting classes in `models.py` so that that becomes available as documentation. 

Note! Landing this does NOT make a link to it. That's because the PII removal hasn't been built yet so we have to be careful with this going live.