From: Brad Jorsch <bjorsch@wikimedia.org>
Date: Tue, 5 May 2015 13:55:26 +0000 (-0400)
Subject: Improve RELEASE-NOTES for recent API change
X-Git-Tag: 1.31.0-rc.0~11397
X-Git-Url: http://git.cyclocoop.org/%7B%24www_url%7Dadmin/compta/operations/?a=commitdiff_plain;h=cf4ccb467c499f9a675ee2f7f9d2e51d3d3acb47;p=lhc%2Fweb%2Fwiklou.git

Improve RELEASE-NOTES for recent API change

Bug: T98086
Change-Id: Ibb8dc283965f4ac2d90dd906e040aec9441f16d1
---

diff --git a/RELEASE-NOTES-1.25 b/RELEASE-NOTES-1.25
index 9bd281bea0..f5cec5454e 100644
--- a/RELEASE-NOTES-1.25
+++ b/RELEASE-NOTES-1.25
@@ -257,7 +257,8 @@ production.
   Title::userCan() via the API.
 * Default type param for query list=watchlist and list=recentchanges has
   been changed from all types (e.g. including 'external') to 'edit|new|log'.
-* Added formatversion to format=json, still experimental.
+* Added formatversion to format=json. Still "experimental" as further changes
+  to the output formatting might still be made.
 * (T73020) Log event details are now always under a 'params' subkey for
   list=logevents, and a 'logparams' subkey for list=watchlist and
   list=recentchanges.
@@ -322,9 +323,10 @@ production.
 * (T35235) LogFormatter subclasses are now responsible for formatting log event
   parameters for the API.
 * Many modules have changed result data formats. While this shouldn't affect
-  clients not using the experimental formatversion=2015, code using
-  ApiResult::getResultData() and not using ApiResult::transformForBC() may need
-  updating.
+  clients not using the experimental formatversion=2, code using
+  ApiResult::getResultData() without the transformations for backwards
+  compatibility may need updating, as will code that wasn't following the old
+  conventions for API boolean output.
 * The following methods have been deprecated and may be removed in a future
   release:
   * ApiBase::getDescription