Page MenuHomePhabricator

Code-review support for Codex PHP
Closed, ResolvedPublic5 Estimated Story Points

Description

Background

The FY25'26 annual plan PES1.4 KR (Codex adoption increase) seeks to achieve the following:

"By the end of Q4, we'll see a 10% adoption rate increase for Codex among P&T teams."

One of the main projects under this effort is releasing a 1.0 version of Codex PHP.
@Catrope is the primary engineer in this effort, however, he needs code-review support to realize this project.

Since the Reader Experience team has some responsibility towards maintaining the Codex library, and, the Codex PHP project is uniquely valuable to the skin ecosystem, the team should be involved in providing code-review for this code.


Requirements

Provide code review for the following patches related to Codex PHP

i18n specifics

The rest of the patches are not included in the task, and we can ask Roan to remove the lower priority patches from the chain if needed.

Acceptance criteria for done

Requirements

Provide code review for the following patches related to Codex PHP

i18n specifics

Also fix shortcomings while there:

  • Failing phan tests – fixed as part of a Outreachy volunteer patch same time
  • Enforcing PHP 8.1+ multiline trailing comma requirement by help of phpcs for better developer experience and consistency throughout codebase

Event Timeline

Jdrewniak renamed this task from Cod-review support for Codex PHP to Code-review support for Codex PHP.Mar 4 2026, 5:30 PM
Jdrewniak updated the task description. (Show Details)
Jdrewniak updated the task description. (Show Details)
SToyofuku-WMF set the point value for this task to 5.Mar 4 2026, 6:59 PM
SToyofuku-WMF subscribed.

From meeting: on Reader Experience, we're going to treat this as a spike - as it stands the work to review seems spooky so let's try to demystify it!

For the person picking up this ticket:

  1. schedule a meeting with Roan and invite the team - everyone is optional, but let's make sure at least 2-3 engineers are present
  2. try to review the patch, with the 5 point value serving as a rough timebox
  3. by the end of this ticket, either the patch will be merged, or we will have a better understanding of why it was not possible to review it within 5 points of time

Note: there are four patches currently in that query - unless otherwise stated, we are focusing on https://gerrit.wikimedia.org/r/c/design/codex-php/+/1230518 for now

AnneT added a subscriber: egardner.
AnneT subscribed.

I'm assigning this to myself as the responsible person, but this will be a collaborative effort between the REx engineers and @egardner

Volker_E added projects: Codex, I18n.
Volker_E updated the task description. (Show Details)
Volker_E added a subscriber: bwang.
Jdrewniak lowered the priority of this task from High to Medium.

Change #1265685 had a related patch set uploaded (by VolkerE; author: VolkerE):

[design/codex-php@main] Fix phan error PhanImpossibleCondition

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

Volker_E updated the task description. (Show Details)

Change #1265720 had a related patch set uploaded (by VolkerE; author: VolkerE):

[design/codex-php@main] lint: Enforce trailing comma rule for multi-line arrays and fix

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

Change #1265685 abandoned by Umherirrender:

[design/codex-php@main] Fix phan error PhanImpossibleCondition

Reason:

Was fixed as part of I3fdae440e7807c4aef5c41caf29c913d1d80d401

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

Change #1265720 merged by jenkins-bot:

[design/codex-php@main] lint: Enforce trailing comma rule for multi-line arrays and fix

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

Volker_E subscribed.

Just boldly go ahead with resolving this.
We went beyond the acceptance criteria in the task description, identified and fixed a few shortcomings in the process.