Stream META data needs to be documented
hybotics opened this issue · comments
I noticed that Stream META data has not been documented. I've been "dancing" around the Stream META["more"] item for a few days. There is no indication when this item is valid and what each state means at a given occurrence when it is valid. ALL META data should be documented in full.
It's documented on these pages:
http://developers.app.net/docs/basics/responses/#response-envelope
http://developers.app.net/docs/basics/pagination/#response-metadata http://developers.app.net/docs/resources/stream-marker/
What more would you like to see?
It's more a matter of where the info is shown. It should be shown under
META, Stream, in the API docs where the other META data is described. It
would be much easier to find it than having to search other parts of the
docs for it.
Also, there is a case where more = False and min_id = max_id. Does this
indicate the current end of the stream?
8-Dale
On Sat, Apr 20, 2013 at 3:50 PM, Bryan Berg notifications@github.comwrote:
It's documented on these pages:
http://developers.app.net/docs/basics/responses/#response-envelope
http://developers.app.net/docs/basics/pagination/#response-metadata
http://developers.app.net/docs/resources/stream-marker/What more would you like to see?
—
Reply to this email directly or view it on GitHubhttps://github.com//issues/333#issuecomment-16712766
.