Page MenuHomePhabricator

Rename classes and methods on page related events to match the design document
Closed, ResolvedPublic2 Estimated Story Points

Description

Per discussion on the design document, we agreed to:

  • Rename methods and classes, while keeping the old names functional
    • rename PageEvent to PageStateEvent (with the idea to introduce another parent class, PageAggregateEvent, that would also cover the revision history)
    • rename PageUpdatedEvent to PageRevisionUpdatedEvent event
    • on PageRevisionUpdatedEvent, rename getNewRevision and getOldRevision to getLatestRevisionAfter and getLatestRevisionBefore
    • replace getPage with getPageId and getPageRecordBefore and getPageRecordAfter
  • Rename methods and classes in extensions:
    • CommunityConfiguration
    • GrowthExperiments
    • ContentTranslation
    • Linter
    • Wikistories
    • Gadgets
  • Remove aliases for methods and classes

Event Timeline

Change #1126624 had a related patch set uploaded (by Daniel Kinzler; author: Daniel Kinzler):

[mediawiki/core@master] DomainEvents: Rename PageEvent and PageUpdatedEvent

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

Change #1126970 had a related patch set uploaded (by Daniel Kinzler; author: Daniel Kinzler):

[mediawiki/core@master] DomainEvents: Rename getOldRevision and getNewRevision

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

Change #1126624 merged by jenkins-bot:

[mediawiki/core@master] DomainEvents: Rename PageEvent and PageUpdatedEvent

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

Change #1127105 had a related patch set uploaded (by Daniel Kinzler; author: Daniel Kinzler):

[mediawiki/core@master] DomainEvents: Model page state before/after

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

Change #1126970 merged by jenkins-bot:

[mediawiki/core@master] DomainEvents: Rename getOldRevision and getNewRevision

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

Decided to change PageStateBefore/After to PageRecordBefore/After, because the page record does not cover all of the page state. Events representing changes to visibility or protection would not be reflected in the page record, so calling it "the page state" would be confusing.

Change #1127105 merged by jenkins-bot:

[mediawiki/core@master] DomainEvents: Model page state before/after

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

aaron updated Other Assignee, added: daniel.

Change #1134114 had a related patch set uploaded (by Daniel Kinzler; author: Daniel Kinzler):

[mediawiki/extensions/Wikistories@master] EventIngress: use getDeletedPage instead of getPageStateBefore

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

daniel triaged this task as High priority.Apr 4 2025, 7:27 AM
daniel lowered the priority of this task from High to Medium.

Change #1134114 merged by jenkins-bot:

[mediawiki/extensions/Wikistories@master] EventIngress: use getDeletedPage instead of getPageStateBefore

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

Change #1134400 had a related patch set uploaded (by Daniel Kinzler; author: Daniel Kinzler):

[mediawiki/extensions/Wikistories@wmf/1.44.0-wmf.23] EventIngress: use getDeletedPage instead of getPageStateBefore

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

Change #1134400 merged by jenkins-bot:

[mediawiki/extensions/Wikistories@wmf/1.44.0-wmf.23] EventIngress: use getDeletedPage instead of getPageStateBefore

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

Mentioned in SAL (#wikimedia-operations) [2025-04-07T06:40:16Z] <daniel@deploy1003> Started scap sync-world: Backport for [[gerrit:1134400|EventIngress: use getDeletedPage instead of getPageStateBefore (T388588 T391051)]]

Mentioned in SAL (#wikimedia-operations) [2025-04-07T08:12:33Z] <daniel@deploy1003> Started scap sync-world: Backport for [[gerrit:1134400|EventIngress: use getDeletedPage instead of getPageStateBefore (T388588 T391051)]]

Mentioned in SAL (#wikimedia-operations) [2025-04-07T08:53:20Z] <daniel@deploy1003> Started scap sync-world: Backport for [[gerrit:1134400|EventIngress: use getDeletedPage instead of getPageStateBefore (T388588 T391051)]]

Mentioned in SAL (#wikimedia-operations) [2025-04-07T08:58:48Z] <daniel@deploy1003> daniel: Backport for [[gerrit:1134400|EventIngress: use getDeletedPage instead of getPageStateBefore (T388588 T391051)]] synced to the testservers (https://wikitech.wikimedia.org/wiki/Mwdebug)

Mentioned in SAL (#wikimedia-operations) [2025-04-07T09:13:03Z] <daniel@deploy1003> Finished scap sync-world: Backport for [[gerrit:1134400|EventIngress: use getDeletedPage instead of getPageStateBefore (T388588 T391051)]] (duration: 19m 43s)

Change #1134745 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[mediawiki/extensions/CommunityConfiguration@master] Rename classes and methods on page related events to match the design document

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

Change #1134749 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[mediawiki/extensions/Wikistories@master] Rename classes and methods on page related events to match the design document

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

Change #1134743 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[mediawiki/extensions/ContentTranslation@master] Rename classes and methods on page related events to match the design document

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

Change #1134747 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[mediawiki/extensions/Linter@master] Rename classes and methods on page related events to match core

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

Change #1134744 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[mediawiki/extensions/GrowthExperiments@master] Rename classes and methods on page related events to match core

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

Change #1134750 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[mediawiki/extensions/Gadgets@master] Rename classes and methods on page related events to match the design document

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

aaron set the point value for this task to 2.Apr 8 2025, 2:30 PM

Change #1135512 had a related patch set uploaded (by Aaron Schulz; author: Aaron Schulz):

[mediawiki/core@master] [WIP] Remove deprecated DomainEvent-related alias classes and methods

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

Change #1134747 merged by jenkins-bot:

[mediawiki/extensions/Linter@master] Rename classes and methods on page related events to match core

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

Change #1134750 merged by jenkins-bot:

[mediawiki/extensions/Gadgets@master] Rename classes and methods on page related events to match core

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

Change #1134749 merged by jenkins-bot:

[mediawiki/extensions/Wikistories@master] Update classes and methods on page related events to match core

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

Change #1134743 merged by jenkins-bot:

[mediawiki/extensions/ContentTranslation@master] Rename classes and methods on page related events to match core

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

Change #1134745 merged by jenkins-bot:

[mediawiki/extensions/CommunityConfiguration@master] Rename classes and methods on page related events to match core

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

daniel updated the task description. (Show Details)

Change #1134744 merged by jenkins-bot:

[mediawiki/extensions/GrowthExperiments@master] Rename classes and methods on page related events to match core

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

Change #1135512 merged by jenkins-bot:

[mediawiki/core@master] DomainEvents: Remove deprecated DomainEvent-related alias classes and methods

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