Page MenuHomePhabricator

Web team: Review stable code (hooks, mw object, undocumented) and mark (un)stable interfaces before 1.42.0
Closed, ResolvedPublic1 Estimated Story Points

Description

The stable interface policy was introduced in September 2023 during the 1.41 MediaWiki release. As a result of the introduction of this policy I am asking teams to take the opportunity to review their existing stable APIs and take appropriate action to limit unsupported APIs where necessary and possible.

TODO

  • Please read the guidelines around what constitutes stable code
  • Please remove any functions on the mw object that you do not wish to consider stable. Note "Code that was never part of a public MediaWiki release, and never consumed according to Codesearch and Global Search MAY be changed (including marked explicitly as @private) or removed without deprecation, since the code has never become part of the stable interface or used."
  • Please add @private or @internal documentation tags to hook events that you wish to limit usage of.

Event Timeline

Change 963191 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/extensions/MobileFrontend@master] Opt out of stable policy for MobileFrontend hooks, remove one

https://gerrit.wikimedia.org/r/963191

Change 963192 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/skins/Vector@master] Define stable and internal APIs

https://gerrit.wikimedia.org/r/963192

Jdlrobson renamed this task from Web team: Review code on mw object and mark (un)stable interfaces before 1.42.0 to Web team: Review stable code (hooks, mw object, undocumented) and mark (un)stable interfaces before 1.42.0.Oct 4 2023, 4:45 PM

Scheduled time for team to talk about this on 11th October.

Jdlrobson set the point value for this task to 1.Oct 10 2023, 5:01 PM
Jdrewniak lowered the priority of this task from High to Lowest.
Jdrewniak raised the priority of this task from Lowest to Low.
Jdrewniak raised the priority of this task from Low to Medium.
Jdrewniak raised the priority of this task from Medium to High.
Jdrewniak subscribed.

Change 963192 merged by jenkins-bot:

[mediawiki/skins/Vector@master] Define stable and internal APIs

https://gerrit.wikimedia.org/r/963192

Change 963191 merged by jenkins-bot:

[mediawiki/extensions/MobileFrontend@master] Opt out of stable policy for MobileFrontend hooks, remove one, limit mw usage

https://gerrit.wikimedia.org/r/963191

We'll fix the deprecation notices as part of T348807

Change 966582 had a related patch set uploaded (by Jdlrobson; author: Jdlrobson):

[mediawiki/extensions/MobileFrontend@master] Expose languages API for Minerva only

https://gerrit.wikimedia.org/r/966582

Change 966582 merged by jenkins-bot:

[mediawiki/extensions/MobileFrontend@master] Expose languages API for Minerva only

https://gerrit.wikimedia.org/r/966582