RELEASE-NOTES-1.41

= MediaWiki 1.41 =

== MediaWiki 1.41.0-PRERELEASE ==

THIS IS NOT A RELEASE YET

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

== Upgrading notes for 1.41 ==
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.41 upgrades are below:
* (T178356) MediaWiki now requires browsers to support ES6 for them to receive
  JavaScript, up from ES5. In practice, this primarily means that users of
  Internet Explorer 11 (EOL in 2022) will no longer get JavaScript tools.
* …

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

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

==== New configuration ====
* …

==== Changed configuration ====
* $wgAuthManagerAutoConfig – When using this setting to modify the
  authentication system in MediaWiki, the classes
  TemporaryPasswordPrimaryAuthenticationProvider,
  LocalPasswordPrimaryAuthenticationProvider and
  EmailNotificationSecondaryAuthenticationProvider now require
  DBLoadBalancerFactory, not DBLoadBalancer, as a service.
* …

==== Removed configuration ====
* …

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

=== New developer features in 1.41 ===
* Added ForeignResourcesDir extension.json / skin.json attribute, which should
  point to the directory holding your foreign-resources.yaml file. See
  https://www.mediawiki.org/wiki/Foreign_resources for background.
* …

=== External library changes in 1.41 ===

==== New external libraries ====
* Added pinia at v2.0.16.
* Added symfony/polyfill-php81 at v1.27.0.

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

==== Changed external libraries ====
* Updated codex, codex-search, codex-design-tokens and codex-icons
  from v0.6.2 to v0.9.1.
* Updated wikimedia/composer-merge-plugin from 2.0.1 to 2.1.0.
* Updated wikimedia/minify from 2.3.0 to 2.4.0.
* Updated wikimedia/less.php from 4.0.0 to 4.1.0.
* …

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

==== Removed external libraries ====
* The `jquery.hoverIntent` module was removed.
* …

=== Bug fixes in 1.41 ===
* …

=== Action API changes in 1.41 ===
* …

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

=== Languages updated in 1.41 ===
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.

* (T332113) Added language support for Northern Hindko (hno).
* (T333425) Added language support for Iraqi (Mesopotamian) Arabic (acm).
* (T332118) Namespace translations for Angika (anp) were added

=== Breaking changes in 1.41 ===
* Article::doDelete(), deprecated since 1.37, has been removed.
* CommentStore::getStore(), deprecated since 1.31, has been removed.
* Article::getRedirectHeaderHtml() no longer accepts an array as $target.
  Passing an array was deprecated in 1.39.
* IDatabase::wasErrorReissuable(), deprecated since 1.40, has been removed.
* The Http class, deprecated since 1.34, with the functions ::request(),
  ::get(), ::post(), ::userAgent(), ::isValidURI(), ::getProxy(),
  ::createMultiClient() have been removed.
* The following unused IDatabase methods were removed without deprecation:
  - ::wasLockTimeout()
  - ::wasConnectionLoss()
* PrevNextNavigationRenderer class, deprecated in 1.39,
  has been removed.
* LinkBatch::__construct() now requires that all parameters be passed. The
  fallback to MediaWikiServices emitted deprecation notices since 1.35.
* The methods IndexPager::getPagingLinks(), IndexPager::getLimitLinks() and
  IndexPager::buildPrevNextNavigation(), deprecated in 1.39,
  have been removed.
* Overriding the method IndexPager::makeLink(), deprecated in 1.39,
  is no longer possible.
* MagicWordFactory::getCacheTime() is deprecated and returns -1.
* IDatabase::lastQuery and IReadableDatabase::lastQuery, deprecated in 1.40,
  is now removed.
* Protected method Database::executeQuery now only takes Query object as
  argument instead of raw SQL string.
* Protected method Database::getTempTableWrites() is now private.
* Config parameter keywordTableMap in DatabasePostgres, deprecated since 1.37,
  has been removed.
* …

=== Deprecations in 1.41 ===
* The MessageCache::get hook is deprecated for performance reasons. Use
  MessageCacheFetchOverrides instead.
* The interface for hook ParserModifyImageHTML have been renamed from
  ParserModifyImageHTML to ParserModifyImageHTMLHook,
  the old name is deprecated.
* (T178356) The es6-polyfills module is deprecated and is now a no-op.
* The following classes are now namespaced under MediaWiki\Specials; the old
  class names are now deprecated aliases:
  - SpecialActiveUsers
  - SpecialAllMessages
  - SpecialAncientPages
  - SpecialApiHelp
  - SpecialApiSandbox
  - SpecialAutoblockList
  - SpecialBlankpage
  - SpecialBlock
  - SpecialBlockList
  - SpecialBookSources
  - SpecialBotPasswords
  - SpecialBrokenRedirects
  - SpecialCategories
  - SpecialChangeContentModel
  - SpecialChangeCredentials
  - SpecialChangeEmail
  - SpecialChangePassword
  - SpecialComparePages
  - SpecialConfirmEmail
  - SpecialContribute
  - SpecialContributions
  - SpecialCreateAccount
  - SpecialDeadendPages
  - SpecialDeletePage
  - SpecialDeletedContributions
  - SpecialDiff
  - SpecialDoubleRedirects
  - SpecialEditPage
  - SpecialEditTags
  - SpecialEditWatchlist
  - SpecialEmailInvalidate
  - SpecialEmailUser
  - SpecialExpandTemplates
  - SpecialExport
* Various mediawiki.ui variables have been deprecated in favor of
  'minerva.skin.variables.less' Codex design tokens featuring replacements.
* The jquery.cookie ResourceLoader module has been merged into the existing
  mediawiki.cookie module; jquery.cookie remains but is deprecated.
* The global function wfGetLangObj is deprecated and emits deprecation
  warnings. Use MediaWiki\Languages\LanguageFactory::getLanguage instead.
* …

=== Other changes in 1.41 ===
* ExternalLinksLookup::getExternalLinksForPage() now exists to centralize
  logic of looking up externallinks rows.
* …

== Compatibility ==

MediaWiki 1.41 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.