On Thu, Dec 20, 2012 at 7:02 PM, Yuri Astrakhan yuriastrakhan@gmail.com wrote:
== Per API ==
A global version=42 parameter will be included in all calls to API, specifying what functionality client is expecting. The number would increase every so often, like once a month to signify "API changes bucket".
Why wouldn't the version of Mediawiki (e.g 1.20.1) work as the "version" of the API? It is true that non-core modules would have to synchronize their releases with versions of Mediawiki, but that seems like a small cost. For most people, the time they will see API breaking changes is when they upgrade to a new version of Mediawiki.
If the version number need to be tied to the month, it would make more sense to make that explicit, e.g. versions "201301", "201302", etc., so there is a more clear link between the version number and the date that it took effect.
- Carl