Hi, Brad,
Do you have any QA instances including all the changes of the new release?
How do you test the new changes before releasing to production?
I think by querying the QA instances, we can monitor the changes of the API
output that we used. That can prevent our production break.
Thanks.
2014/1/2 Brad Jorsch (Anomie) <bjorsch(a)wikimedia.org>
On Thu, Jan 2, 2014 at 3:58 AM, Liu Chenheng
<liuchenheng(a)gmail.com>wrote;wrote:
I'd like to be notified as soon as the API
changes. A simple way is to
monitor the page
http://en.wikipedia.org/w/api.php
Here is my problem:
Will the page
http://en.wikipedia.org/w/api.php be always updated when
the API changes (i.e. add/remove some new params) or the format of the
response changes.
If not, are there any ways to monitor that? Thanks
Changes to the input parameters will show up in the API help, but changes
in the output format will not.
Changes to the output format that are likely to break existing API users
should be announced to the mediawiki-api-announce list;[1] these are also
sent to this list automatically.
Changes to core API modules are also generally added to the RELEASE-NOTES
file in the MediaWiki source,[2] under the "API" section, although this is
sometimes forgotten due to the likelihood of merge conflicts (think "edit
conflicts"), and changes to API modules added by extensions are not
included there.
Each WMF-deployed branch of MediaWiki has a page[3] that lists the
individual code changes since the last deployment branch. If nothing else,
you could read through that.
[1]:
https://lists.wikimedia.org/mailman/listinfo/mediawiki-api-announce
[2]: Currently
https://git.wikimedia.org/blob/mediawiki%2Fcore.git/master/RELEASE-NOTES-1.…
[3]: e.g.
https://www.mediawiki.org/wiki/MediaWiki_1.23/wmf8
--
Brad Jorsch (Anomie)
Software Engineer
Wikimedia Foundation
_______________________________________________
Mediawiki-api mailing list
Mediawiki-api(a)lists.wikimedia.org
https://lists.wikimedia.org/mailman/listinfo/mediawiki-api