Add an "overview" document with higher-level description of the service.
Start expanding API docs with more detail.
Add proposed error conditions to endpoint descriptions.
Update document error codes based on feedback from dcoates and warner.
Merge pull request #232 from mozilla/doc-updates

Document url structure and error codes