MediaWiki 1.37.4 is the most recent version in 1.37 line as of 2022-09-15. The most recent version should be used as a base for the Wikibase Suite release.

This release is to include the current experimental version of Federated PropertiesDue to high technical complexity of providing it in this release, and very short life of the release (MW 1.37 becomes end of life in Nov 2022), Federated Properties functionality is to completely disabled in this version. It should be made clear to the users of early Wikibase Suite releases that the Federated Properties version from earlier versions is not compatible with the now provided version and they might encounter issues during the upgrade.

There should be clearly documented process of upgrading from earlier versions of Wikibase Suite. For version compatible with MW 1.35 it will likely involve two-step upgrade via MW 1.36 compatible version first due to technical limitations.

Acceptance criteria

• Container images of Wikibase Suite compatible with MediaWiki 1.37.4 have been prepared, tested and published to Docker hub
• Tarball packages of Wikibase Suite compatible with MediaWiki 1.37.4 have been prepared, tested and published to releases.wikimedia.org
• Update path from Wikibase Suite versions compatible with MediaWiki 1.35 and 1.36 have been documented for their users.

Releasing checklist (copied from T316707)

• Create a task on phabricator with this template
• Collect subtasks that need to be included in the release, adding this task as a parent (including security tasks) # Nothing inparticular
• Review open backports for Wikimedia controlled Gerrit extensions included in the release, merging where appropriate link (check that all extensions are included in the search and the correct REL_x version is used)
  • • https://gerrit.wikimedia.org/r/c/mediawiki/extensions/OAuth/+/834538 - Avoid passing null to PHP 8.1 functions that don't support it # Not going to bother with
  • https://github.com/ProfessionalWiki/WikibaseLocalMedia/tags
  • https://github.com/ProfessionalWiki/WikibaseEdtf/tags
• Create a draft PR for the new release in the releasing repository # https://github.com/wmde/wikibase-release-pipeline/pull/357
  • Make the pipeline build the new release by changing env_file in .github/workflows/built_and_test.yml
  • When doing a new "major" release for a new "major" version of MediaWiki, make sure there is an upgrade path. See test_upgrade_base and test_upgrade_bundle in .github/workflows/built_and_test.yml # Not needed for this security release
• Make the draft PR green
• Prepare the final round of patches
  • Disable feddy props https://gerrit.wikimedia.org/r/c/mediawiki/extensions/Wikibase/+/842868 # Merged
  • Release notes in Wikibase.git https://gerrit.wikimedia.org/r/c/mediawiki/extensions/Wikibase/+/843568
  • Any security patches for any codebases # None
• Prepare communication with ComCom & Technical Writer
• Merge final patches
  • Disable feddy props https://gerrit.wikimedia.org/r/c/mediawiki/extensions/Wikibase/+/842868 # Merged
  • Release notes in Wikibase.git https://gerrit.wikimedia.org/r/c/mediawiki/extensions/Wikibase/+/843568
• Update any needed commit hashes in the release env file
• Merge the release PR
• Test and verify RC candidates
  • Deploy artefacts to test the system https://wikibase-product-testing.wmcloud.org
  • Verify against acceptance criteria
• Publish release candidates https://github.com/wmde/wikibase-release-pipeline/blob/main/docs/topics/publishing.md
  • dockerhub
  • releases.wikimedia.org
  • Tags
  • Docs
    • mw.org
    • docker-compose example
  • Record build meta data https://github.com/wmde/wikibase-release-pipeline/pull/375
• Communication