From 506c2f4d57c10c5b3b1a2d9ce88670768d1203a5 Mon Sep 17 00:00:00 2001 From: Timo Tijhof Date: Sat, 1 Sep 2018 20:50:15 +0100 Subject: [PATCH] RELEASE-NOTES: Use New/Changed/Removed pattern for Configuration section MIME-Version: 1.0 Content-Type: text/plain; charset=utf8 Content-Transfer-Encoding: 8bit This was already used for external libraries. This commit changes the order to be consistently 'New/Changed/Removed', and adopts the pattern for configuration changes as well. For improved scannability, the bullet points now start with the name of the configuration setting(s), followed by a sentence, with an optional ticket in brackets after the sentence(s). * A number of bullet points under "Configuration changes" were in fact, not configuration changes. These have been moved to "New features" or "Other changes" for now. * Add mention of the relevant configuration variable to some of the release notes: $wgTidyDriver, `watchlistdays`, $wgGroupPermissions, $wgGroupPermissions. Also fix ReleaseNotesTest to count characters, not bytes, this was causing it to count – as two, and € as three. Change-Id: Ie89dac6408f8a8dafbf59efe73a11f4d282c0c6b --- RELEASE-NOTES-1.32 | 92 ++++++++++--------- .../documentation/ReleaseNotesTest.php | 2 +- 2 files changed, 51 insertions(+), 43 deletions(-) diff --git a/RELEASE-NOTES-1.32 b/RELEASE-NOTES-1.32 index ab008db9f1..34dbfd9ac4 100644 --- a/RELEASE-NOTES-1.32 +++ b/RELEASE-NOTES-1.32 @@ -6,42 +6,49 @@ MediaWiki 1.32 is an alpha-quality branch and is not recommended for use in production. === Configuration changes in 1.32 === -* (T115414) The $wgEnableAPI and $wgEnableWriteAPI settings, deprecated in 1.31, - have been removed. -* The $wgUseAjax setting, deprecated in 1.31, is now ignored. -* The $wgSiteSupportPage setting, unused since 1.5, was removed. -* The $wgBrowserBlacklist setting, deprecated in 1.30, was removed. -* The default quality of JPEG thumbnails generated by GD was reduced from 95 to - 80. The quality of JPEG thumbnails is now configurable through the new setting - $wgJpegQuality (default 80). This aligns the quality to what ImageMagick uses. -* $wgExperimentalHtmlIds, deprecated since 1.30, has been removed. The - 'html5-legacy' value for $wgFragmentMode is no longer accepted. -* The experimental Html5Internal and Html5Depurate tidy drivers were removed. - RemexHtml, which is the default, should be used instead. -* (T135963) You can now define a Content Security Policy for your wiki. This - adds a defense-in-depth feature to stop an attacker who has found a bug in - the parser allowing them to insert malicious attributes. Disabled by default, - you can configure this via $wgCSPHeader and $wgCSPReportOnlyHeader. -* New configuration variable has been added: $wgCookieSetOnIpBlock. - This determines whether to set a cookie when an IP user is blocked. Doing so - means that a blocked user, even after moving to a new IP address, will still - be blocked. -* The archive table's ar_rev_id field is now unique. -* Special:BotPasswords now requires reauthentication. -* (T194414) The default watchlist view time has been increased from 3 to 7 days. -* The right to edit sitewide Javascript (e.g. MediaWiki:Common.js), CSS or JSON - was separated from 'editinterface' and is available under - 'editsitejs'/'editsitecss'/'editsitejson'. Having 'editinterface' is still - necessary to edit such pages. -* A new user group, 'interface-admin', is added for controlling access to - sitewide CSS/JS (and editing other users' CSS/JS). No other group has - 'editsitecss', 'editusercss', 'editsitejs' or 'edituserjs' by default. -* A new grant group, 'editsiteconfig', is added for granting the above rights. -* The $wgPasswordSenderName setting, ignored since 1.23 by MediaWiki and almost - all extensions, is no longer set at all. Instead, you can modify the system - message `emailsender`. -* A new configuration setting, $wgRawHtmlMessages, is added, for listing + +==== New configuration ==== +* $wgJpegQuality – The quality of JPEG thumbnails is now configurable through + this setting. The default is 80, which matches the quality of JPEG thumbnails + previously generated by ImageMagick. The quality of JPEG thumbnails generated + by GD was previously 95, but now uses the $wgJpegQuality setting as well. +* $wgCookieSetOnIpBlock - This determines whether to set a cookie when an IP + user is blocked. Doing so means that a blocked user, even after moving to a + new IP address, will still be blocked. +* $wgRawHtmlMessages – This new configuration setting is added for listing messages which are displayed as raw HTML. +* $wgCSPHeader and $wgCSPReportOnlyHeader – You can now define a + "Content Security Policy" for your wiki. This adds a defense-in-depth feature + to stop an attacker who has found a bug in the parser allowing them to insert + malicious attributes. Disabled by default. (T135963) +* $wgGroupPermissions – A new user group, 'interface-admin', is added for + controlling access to sitewide CSS/JS (and editing other users' CSS/JS). No + other group has 'editsitecss', 'editusercss', 'editsitejs' or 'edituserjs' + by default. +* $wgGrantPermissions – A new grant group, 'editsiteconfig', is added for + granting the above rights. + +==== Changed configuration ==== +* $wgUseAjax – This setting, deprecated in 1.31, is now ignored. +* $wgDefaultUserOptions – The default watchlist view time (watchlistdays) has + been increased from 3 to 7 days. (T194414) +* $wgGroupPermissions – The right to edit sitewide Javascript + (e.g. MediaWiki:Common.js), CSS or JSON was separated from 'editinterface' + and is available under 'editsitejs'/'editsitecss'/'editsitejson'. Having + 'editinterface' is still necessary to edit such pages. + +==== Removed configuration ==== +* $wgEnableAPI and $wgEnableWriteAPI – These settings, deprecated in 1.31, + have been removed. (T115414) +* $wgSiteSupportPage – This setting, unused since 1.5, was removed. +* $wgBrowserBlacklist – This setting, deprecated in 1.30, was removed. +* $wgExperimentalHtmlIds – This setting, deprecated since 1.30, was removed. + The 'html5-legacy' value for $wgFragmentMode is no longer accepted. +* $wgPasswordSenderName - This setting, ignored since 1.23 by MediaWiki and + most extensions, is no longer set. Instead, you can modify the system + message `emailsender`. +* $wgTidyConfig – The experimental Html5Internal and Html5Depurate tidy drivers + were removed. RemexHtml, which is the default, should be used instead. === New features in 1.32 === * (T112474) Generalized the ResourceLoader mechanism for overriding modules @@ -84,10 +91,13 @@ production. updated for the changed method signature. === External library changes in 1.32 === + +==== New external libraries ==== +* Added wikimedia/xmp-reader 0.6.0 * … -==== Upgraded external libraries ==== -* Updated QUnit from 2.4.0 to 2.6.0. +==== Changed external libraries ==== +* Updated qunitjs from 2.4.0 to 2.6.0. * Updated wikimedia/scoped-callback from 1.0.0 to 2.0.0. ** ScopedCallback objects can no longer be serialized. * Updated wikimedia/wrappedstring from 2.3.0 to 3.0.1. @@ -97,11 +107,7 @@ production. * Updated wikimedia/timestamp from 1.0.0 to 2.0.0. * Updated wikimedia/remex-html from 1.0.3 to 2.0.0. -==== New external libraries ==== -* Added wikimedia/xmp-reader 0.6.0 -* … - -==== Removed and replaced external libraries ==== +==== Removed external libraries ==== * … === Bug fixes in 1.32 === @@ -411,6 +417,8 @@ because of Phabricator reports. * OOUI HTMLForm will now display help text inline after the input field, rather than in a popup. Previous behavior can be restored by using `'help-inline' => false`. +* The archive table's ar_rev_id field is now unique. +* Special:BotPasswords now requires reauthentication. * … == Compatibility == diff --git a/tests/phpunit/documentation/ReleaseNotesTest.php b/tests/phpunit/documentation/ReleaseNotesTest.php index 4de071d65a..ac100aff80 100644 --- a/tests/phpunit/documentation/ReleaseNotesTest.php +++ b/tests/phpunit/documentation/ReleaseNotesTest.php @@ -45,7 +45,7 @@ class ReleaseNotesTest extends MediaWikiTestCase { $this->assertLessThanOrEqual( // FILE_IGNORE_NEW_LINES drops the \n at the EOL, so max length is 80 not 81. 80, - strlen( $line ), + mb_strlen( $line ), "Release notes file '$fileName' line $i is longer than 80 chars:\n\t'$line'" ); } -- 2.20.1