Complete an initial edit pass over the API spec.
Make a final edit pass.

* Tightened up language.

* Fixed the examples to choose last_processed_stories_id by looking at the processed_stories_id of the last story in the previous response rather than simplely adding a constant.