RELEASE-NOTES-1.38
= Wikibase 1.38 =
This is not a release yet!
== Upgrading notes for 1.38 ==
Don't forget to always back up your database before upgrading!
Some specific notes for Wikibase 1.38 upgrades are below:
Wikibase 1.38 features a new change dispatching scheme, replacing the old one.
If you were regularly running the `dispatchChanges.php` and `pruneChanges.php` maintenance scripts,
you can stop doing that now (e.g. remove any such cron jobs), they are no longer necessary.
For the migration, we suggest the following procedure:
- Run `pruneChanges.php --ignore-dispatch --keep-days 30`, to remove very old changes.
(“Changes” refers to entries in the Wikibase change dispatching mechanism –
your revision history will be kept, of course.)
- Set the wiki to read-only mode.
- Run `dispatchChanges.php` and wait until there is nothing left to dispatch.
(Terminate the script once it says “Idle: No client wiki found in need of dispatching.”)
- Run `runJobs.php`, including on any client wikis, to process any dispatched changes.
- Run `pruneChanges.php`, to remove changes that are now dispatched.
- Update the code of the wiki (and any client wikis) to 1.38.
- Perform any regular MediaWiki post-update steps,
such as updating Composer dependencies and running `update.php`.
- Run `ResubmitChanges.php`, to move remaining changes into the job queue.
- Resume automatic job runners, if you have any (now using the new code).
For a general manual to upgrade MediaWiki see:
https://www.mediawiki.org/wiki/Manual:Upgrading
=== Configuration changes for system administrators in 1.38 ===
==== New configuration ====
* ...
==== Changed configuration ====
* (client) (T293246) If you configure your own entity sources,
and the entity source referred to by the `itemAndPropertySourceName` setting has a string as the `repoDatabase`,
then that string must also be a site ID of the repo wiki.
(This was true before in some setups, but is more important now.)
If you have a single wiki that is both a repo and a client,
it’s recommended to set the `repoDatabase` to `false`.
* ...
==== Removed configuration ====
* (repo) (T292604) dispatchBatchChunkFactor has been removed.
* (repo) (T292604) dispatchDefaultBatchSize has been removed.
* (repo) (T292604) dispatchDefaultMaxChunks has been removed.
* (repo) (T292604) dispatchDefaultDispatchInterval has been removed.
* (repo) (T292604) dispatchDefaultDispatchRandomness has been removed.
* (repo) (T292604) dispatchMaxTime has been removed.
* (repo) (T292604) dispatchIdleDelay has been removed.
* (repo) (T292604) dispatchLagToMaxLagFactor has been removed.
* (repo) (T292604) dispatchingLockManager has been removed.
* ...
=== New user-facing features in 1.38 ===
* ...
=== External library changes in 1.38 ===
==== New external libraries ====
* ...
==== Changed external libraries ====
* ...
==== Removed external libraries ====
* (T12345) ...
=== Bug fixes in 1.38 ===
* (T12345) ...
=== Action API changes in 1.38 ===
* (T12345) ...
=== Languages updated in 1.38 ===
Wikibase supports over 300 languages. Many localisations are updated regularly.
Below only new and removed languages are listed, as well as changes to languages
because of Phabricator reports.
New monolingual support:
* (T12345) ...
Monolingual entries removed as they are now natively supported by MediaWiki:
* (T12345) ...
=== Breaking changes in 1.38 ===
* (T12345) ...
=== Deprecations in 1.38 ===
* (T12345) ...
=== Other changes in 1.38 ===
* (T12345) ...
== Online documentation ==
Installation instructions and FAQ
https://www.mediawiki.org/wiki/Wikibase
Developer documentation of Wikibase 1.38
https://doc.wikimedia.org/Wikibase/REL1_38/
== Mailing list ==
Discussion regarding the development of Wikidata
https://lists.wikimedia.org/mailman/listinfo/wikidata-tech
== IRC help ==
Questions related to wikibase and wikidata can be asked in #wikidata on irc.libera.chat.