Update stability annotations to conform to new policy
Closed, ResolvedPublic
Actions

Assigned To

Authored By

	daniel
	Jul 13 2020, 8:51 AM

Description

Since the new version of the Stable Interface policy has been approved (T255803), the annotations added so far (T247862) need to be updated to conform to the new version of the policy. This should be done before the 1.35 release is branched. Specifically, the following should be replaced:

@stable for calling by @stable to call
@stable for subclassing by @stable to extend
@stable for overriding by @stable to override
@stable for implementation by @stable to implement
@unstable for implementation by @stable to type

The @newable annotation remains the same, as do @unstable, @internal, and @deprecated.

Details

Subject	Repo	Branch	Lines +/-
pager: Clean up file headers and `@ingroup`	mediawiki/core	master	+48 -50
Fix some @stable for ... annotations to use @stable to ...	mediawiki/core	master	+27 -27
Replace "@stable for implementation" with "@stable to implement"	mediawiki/core	master	+554 -554
Replace "@stable for calling" by "@stable to call"	mediawiki/core	master	+118 -118
Replace "@stable for subclassing" with "@stable to extend"	mediawiki/core	master	+107 -107
Replace "@stable for overriding" with "@stable to override"	mediawiki/core	master	+700 -700

Customize query in gerrit

Related Objects

Mentioned Here: T247862: Stable Interface Policy annotations
T255803: RFC: Amendment to the Stable interface policy, June 2020

Event Timeline

daniel created this task.Jul 13 2020, 8:51 AM

Restricted Application added a subscriber: Aklapper. · View Herald TranscriptJul 13 2020, 8:51 AM

daniel updated the task description. (Show Details)Jul 13 2020, 8:51 AM

daniel updated the task description. (Show Details)

Change 612154 had a related patch set uploaded (by Daniel Kinzler; owner: Daniel Kinzler):
[mediawiki/core@master] Replace "@stable for calling" by "@stable to call"

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

gerritbot added a project: Patch-For-Review.Jul 13 2020, 8:54 AM

Change 612156 had a related patch set uploaded (by Daniel Kinzler; owner: Daniel Kinzler):
[mediawiki/core@master] Replace "@stable for overriding" with "@stable to override"

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

Change 612158 had a related patch set uploaded (by Daniel Kinzler; owner: Daniel Kinzler):
[mediawiki/core@master] Replace "@stable for subclassing" with "@stable to extend"

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

Change 612159 had a related patch set uploaded (by Daniel Kinzler; owner: Daniel Kinzler):
[mediawiki/core@master] Replace "@stable for implementation" with "@stable to implement"

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

Change 612156 merged by jenkins-bot:
[mediawiki/core@master] Replace "@stable for overriding" with "@stable to override"

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

Change 612154 merged by jenkins-bot:
[mediawiki/core@master] Replace "@stable for calling" by "@stable to call"

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

Change 612158 merged by jenkins-bot:
[mediawiki/core@master] Replace "@stable for subclassing" with "@stable to extend"

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

Change 612159 merged by jenkins-bot:
[mediawiki/core@master] Replace "@stable for implementation" with "@stable to implement"

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

daniel updated the task description. (Show Details)Jul 13 2020, 9:56 AM

ReleaseTaggerBot added a project: MW-1.35-notes (1.35.0-wmf.41; 2020-07-14).Jul 13 2020, 10:00 AM

Maintenance_bot removed a project: Patch-For-Review.Jul 13 2020, 10:10 AM

Akuckartz awarded a token.Jul 14 2020, 7:15 PM

Akuckartz added a project: MediaWiki-Stakeholders-Group.

Akuckartz subscribed.

BPirkle triaged this task as High priority.Jul 14 2020, 8:30 PM

BPirkle edited projects, added Platform Team Workboards (Green); removed Platform Engineering.

• eprodromou removed a project: Platform Team Workboards (Green).Jul 29 2020, 1:25 PM

Akuckartz moved this task from Needs Discussion to Doing on the MediaWiki-Stakeholders-Group board.Jul 30 2020, 6:16 PM

Reedy moved this task from Blocker to Done on the MW-1.35-release board.Aug 26 2020, 1:09 PM

Reedy renamed this task from Update stability annotations to conform to new policy. to Update stability annotations to conform to new policy.Jan 8 2021, 3:01 AM

Change 703564 had a related patch set uploaded (by DannyS712; author: DannyS712):

[mediawiki/core@master] Fix some @stable for ... annotations to use @stable to ...

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

gerritbot added a project: Patch-For-Review.Jul 8 2021, 2:51 AM

Change 703564 merged by jenkins-bot:

[mediawiki/core@master] Fix some @stable for ... annotations to use @stable to ...

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

ReleaseTaggerBot added a project: MW-1.37-notes (1.37.0-wmf.14; 2021-07-12).Jul 12 2021, 5:00 PM

Aklapper removed a project: Patch-For-Review.Aug 16 2022, 10:17 AM

Aklapper added a project: MediaWiki-General.

Removing task assignee due to inactivity as this open task has been assigned for more than two years. See the email sent to the task assignee on August 22nd, 2022.
Please assign this task to yourself again if you still realistically [plan to] work on this task - it would be welcome!
If this task has been resolved in the meantime, or should not be worked on ("declined"), please update its task status via "Add Action… 🡒 Change Status".
Also see https://www.mediawiki.org/wiki/Bug_management/Assignee_cleanup for tips how to best manage your individual work in Phabricator. Thanks!