Page MenuHomePhabricator

Update stability annotations to conform to new policy
Open, HighPublic

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.

Event Timeline

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

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

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

Change 703564 merged by jenkins-bot:

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

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