Change minor phrasing in the API docs.

Also cut lines at 80 chars.
Merge pull request #37 from mozilla-services/enhance-api-docs

Change minor phrasing in the API docs.