On Thu, Mar 21, 2013 at 8:03 PM, Brad Jorsch bjorsch@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