On Thu, Dec 20, 2012 at 7:02 PM, Yuri Astrakhan <yuriastrakhan(a)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