On Thu, Mar 21, 2013 at 8:03 PM, Brad Jorsch <bjorsch(a)wikimedia.org> wrote:
Remember that clients should not be depending on the
specific query string data returned inside the query-continue node, with either the
old-style or new style continuation.
I am not certain what this means. The names of the continuation
parameters have long been documented in the API spec at
http://www.mediawiki.org/wiki/API:Main_page .
For example,
http://www.mediawiki.org/wiki/API:Embeddedin
states that the continuation parameter for that module is named 'eicontinue'.
The established system was that the content of the continuation
parameters is opaque, but the names of the continuation parameters are
always the same. So for "old-style" continuation we were free to
hard-code the string "eicontinue" into an API client because that was
part of the documented spec.
If part of the change with the new continuation system is that the
entire contents of the 'query-continue' node should be treated as
opaque, rather than just the values of the continuation parameters,
the documentation will need to be overhauled to make that more
obvious.
- Carl