RELEASE-NOTES-1.42

= MediaWiki 1.42 =

== MediaWiki 1.42.0-PRERELEASE ==

THIS IS NOT A RELEASE YET

MediaWiki 1.42 is an alpha-quality development branch, and is not recommended
for use in production.

== Upgrading notes for 1.42 ==
Don't forget to always back up your database before upgrading!

See the file UPGRADE for more detailed per-version upgrade instructions from the
oldest supported upgrading version, MediaWiki 1.35.

Some specific notes for MediaWiki 1.42 upgrades are below:
* …

For notes on 1.41.x and older releases, see HISTORY.

=== Configuration changes for system administrators in 1.42 ===
* …

==== New configuration ====
* $wgEditRecoveryExpiry: Number of seconds to keep edit recovery data
  after the edit is stored.
* …

==== Changed configuration ====
* …

==== Removed configuration ====
* $wgDisableCookieCheck has been removed.
* …

=== New user-facing features in 1.42 ===
* …

=== New features for sysadmins in 1.42 ===
* …

=== New developer features in 1.42 ===
* …

=== External library changes in 1.42 ===

==== New external libraries ====
* Added mediawiki/json-codec at v2.2.1
* …

===== New development-only external libraries =====
* …

==== Changed external libraries ====
* Updated OOUI from v0.48.1 to v0.48.2.
* …

===== Changed development-only external libraries =====
* Upgraded QUnit from v2.19.4 to v2.20.0.
* …

==== Removed external libraries ====
* …

=== Bug fixes in 1.42 ===
* …

=== Action API changes in 1.42 ===
* APIQueryTags now includes "software" in the "source" array for software
  generated tags. Reliance on the "extension" entries in this array is now
  deprecated, but they will remain for backwards compatibility.
* …

=== Action API internal changes in 1.42 ===
* …

=== Languages updated in 1.42 ===
MediaWiki supports over 350 languages. Many localisations are updated regularly.
Below only new and removed languages are listed, as well as changes to languages
because of Phabricator reports.

* …

=== Breaking changes in 1.42 ===
* UserRightsProxy, deprecated since 1.38, has been removed.
* UserLoginCompleteHook is always called with its $direct parameter set to
  boolean true. The false case has been removed.
* MagicWord::load() has been marked @internal and may change in the future
  without further notice.
* MediaWiki's virtualrest internal library has been removed in favor of the
  HTTP library like: Guzzle, MultiHttpClient or MwHttpRequest.
* …

=== Deprecations in 1.42 ===
* API modules using ApiBase::requirePostedParameters() must also override
  mustBePosted() to return true.
* BlockManager::getUserBlock() was deprecated. Instead use
  BlockManager::getBlock(), which expects the caller to do ipblock-exempt
  checking.
* MagicWord::getId() has been deprecated.
* User::isBlocked(), ::isBlockedFromCreateAccount() and ::isBlockedFrom() now
  emit deprecation warnings. They were deprecated since 1.34, 1.37 and 1.33
  respectively.
* Status::setMessageLocalizer is deprecated. Callers that want to control the
  localization of the Status object should obtain a StatusFormatter from
  the StatusFormatterFactory.
* Vuex has been deprecated in favor of its successor, Pinia. Though deprecated,
  Vuex 4 will remain accessible for the foreseeable future. Pinia should be used
  for new projects.
* Title::getBrokenLinksFrom() has been deprecated.
* …

=== Other changes in 1.42 ===
* …

== Compatibility ==

MediaWiki 1.42 requires PHP 7.4.3 or later and the following PHP extensions:

* ctype
* dom
* fileinfo
* iconv
* intl
* json
* mbstring
* xml

MariaDB is the recommended database software. MySQL, PostgreSQL, or SQLite can
be used instead, but support for them is somewhat less mature.

The supported versions are:

* MariaDB 10.3 or higher
* MySQL 5.7.0 or higher
* PostgreSQL 10 or later
* SQLite 3.8.0 or later

== Online documentation ==
Documentation for both end-users and site administrators is available on
MediaWiki.org, and is covered under the GNU Free Documentation License (except
for pages that explicitly state that their contents are in the public domain):

       https://www.mediawiki.org/wiki/Special:MyLanguage/Documentation

== Mailing list ==
A mailing list is available for MediaWiki user support and discussion:

       https://lists.wikimedia.org/mailman/listinfo/mediawiki-l

A low-traffic announcements-only list is also available:

       https://lists.wikimedia.org/mailman/listinfo/mediawiki-announce

It's highly recommended that you sign up for one of these lists if you're
going to run a public MediaWiki, so you can be notified of security fixes.

== IRC help ==
There's usually someone online in #mediawiki on irc.libera.chat.