Page MenuHomePhabricator
Create Task
Maniphest T411517

Clean up Math API OpenAPI specs and remove data-parsoid route specs
Open, MediumPublic1 Estimated Story Points
Actions

Description

Description

We recently completed work to break out the Math API into its own spec, hosted through wikimedia.org instead of the standard per-wiki path. Although the module was renamed correctly, there are additional areas that require clean up for clarity within the Sandbox experience.

Conditions of acceptance

  • Update 'Math' header --> it currently reads "Wikimedia REST API" which is in conflict with the actual Wikimedia REST API. It should instead read "Math API".
  • Update initial description for the Math API for accuracy --> Halley will help review and suggest changes.
  • Update stability policy to read as "deprecated" for the deprecated per-wiki Math endpoints --> https://www.mediawiki.org/wiki/API_versioning#Deprecated
  • Remove /page/data-parsoid endpoint from the per-wiki specs. --> See: https://phabricator.wikimedia.org/T393557

Details

Related Changes in Gerrit:
SubjectRepoBranchLines +/-
Remove /data-parsoid/ endpoint from specs per T393557operations/mediawiki-configmaster+5 -5
Update Math API title and project-specific /math/ endpoint stability policyoperations/mediawiki-configmaster+6 -6
Customize query in gerrit

Related Objects

Event Timeline

HCoplin-WMF created this task.Tue, Dec 2, 4:34 PM
Restricted Application added a subscriber: Aklapper. · View Herald TranscriptTue, Dec 2, 4:34 PM
HCoplin-WMF updated the task description. (Show Details)Tue, Dec 2, 4:35 PM
aaron triaged this task as Medium priority.Tue, Dec 2, 5:14 PM
aaron moved this task from Committed to In Progress on the MW-Interfaces-Team (MWI-Sprint-24 (2025-12-02 to 2025-12-24)) board.
aaron set the point value for this task to 1.
HCoplin-WMF updated the task description. (Show Details)Tue, Dec 2, 6:45 PM
gerritbot added a comment.Tue, Dec 2, 7:29 PM

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

[operations/mediawiki-config@master] Update Math API title and project-specific /math/ endpoint stability policy

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

gerritbot added a project: Patch-For-Review.Tue, Dec 2, 7:29 PM
aaron renamed this task from Clean up Math API OpenAPI specs to Clean up Math API OpenAPI specs and remove data-parsoid route specs.Tue, Dec 2, 9:02 PM
gerritbot added a comment.Tue, Dec 2, 9:03 PM

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

[operations/mediawiki-config@master] Remove /data-parsoid/ endpoint per T393557

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

gerritbot added a comment.Wed, Dec 3, 9:44 PM

Change #1214142 merged by jenkins-bot:

[operations/mediawiki-config@master] Update Math API title and project-specific /math/ endpoint stability policy

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

Stashbot added a comment.Wed, Dec 3, 9:45 PM

Mentioned in SAL (#wikimedia-operations) [2025-12-03T21:45:10Z] <aaron@deploy2002> Started scap sync-world: Backport for [[gerrit:1214142|Update Math API title and project-specific /math/ endpoint stability policy (T411517)]]

Stashbot added a comment.Wed, Dec 3, 9:47 PM

Mentioned in SAL (#wikimedia-operations) [2025-12-03T21:47:26Z] <aaron@deploy2002> aaron: Backport for [[gerrit:1214142|Update Math API title and project-specific /math/ endpoint stability policy (T411517)]] synced to the testservers (see https://wikitech.wikimedia.org/wiki/Mwdebug). Changes can now be verified there.

Stashbot added a comment.Wed, Dec 3, 9:53 PM

Mentioned in SAL (#wikimedia-operations) [2025-12-03T21:53:35Z] <aaron@deploy2002> Finished scap sync-world: Backport for [[gerrit:1214142|Update Math API title and project-specific /math/ endpoint stability policy (T411517)]] (duration: 08m 25s)

gerritbot added a comment.Thu, Dec 4, 9:13 PM

Change #1214143 merged by jenkins-bot:

[operations/mediawiki-config@master] Remove /data-parsoid/ endpoint from specs per T393557

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

Stashbot mentioned this in T393557: Block external traffic to RESTBase /page/data-parsoid endpoint and investigate internal usage.Thu, Dec 4, 9:14 PM
Stashbot mentioned this in T399664: Expand 2FA Opt-In Privileges.

Mentioned in SAL (#wikimedia-operations) [2025-12-04T21:14:03Z] <jforrester@deploy2002> Started scap sync-world: Backport for [[gerrit:1215251|[tokwiki] Allow sysops to grant/remove confirmed status (T411683)]], [[gerrit:1214659|OATHAuth: Remove wmgOATHAuthDisableRight (T399664)]], [[gerrit:1214143|Remove /data-parsoid/ endpoint from specs per T393557 (T411517)]], [[gerrit:1215263|Shorten 'close' cookie wait period for enwiki banners (T411800)]]

Stashbot mentioned this in T411683: Allow tokwiki admins to grant and remove 'confirmed'.Thu, Dec 4, 9:14 PM
Stashbot mentioned this in T411800: CentralNotice code changes to show a banner to a reader with the 'waitdate: close' status.
Stashbot added a comment.Thu, Dec 4, 9:18 PM

Mentioned in SAL (#wikimedia-operations) [2025-12-04T21:18:17Z] <jforrester@deploy2002> mstyles, aaron, superpes, jforrester, ejegg: Backport for [[gerrit:1215251|[tokwiki] Allow sysops to grant/remove confirmed status (T411683)]], [[gerrit:1214659|OATHAuth: Remove wmgOATHAuthDisableRight (T399664)]], [[gerrit:1214143|Remove /data-parsoid/ endpoint from specs per T393557 (T411517)]], [[gerrit:1215263|Shorten 'close' cookie wait period for enwiki banners (T411800)]] synced to the t

Stashbot added a comment.Thu, Dec 4, 9:24 PM

Mentioned in SAL (#wikimedia-operations) [2025-12-04T21:24:07Z] <jforrester@deploy2002> Finished scap sync-world: Backport for [[gerrit:1215251|[tokwiki] Allow sysops to grant/remove confirmed status (T411683)]], [[gerrit:1214659|OATHAuth: Remove wmgOATHAuthDisableRight (T399664)]], [[gerrit:1214143|Remove /data-parsoid/ endpoint from specs per T393557 (T411517)]], [[gerrit:1215263|Shorten 'close' cookie wait period for enwiki banners (T411800)]] (duration: 10m 04s)

Maintenance_bot removed a project: Patch-For-Review.Thu, Dec 4, 9:31 PM
aaron updated the task description. (Show Details)Fri, Dec 5, 11:24 PM
aaron updated the task description. (Show Details)
aaron added a comment.Fri, Dec 5, 11:32 PM

"This API provides cacheable and straightforward access to Wikimedia content and data, in machine-readable formats." should say something more specific, like "This API provides verification and cacheable rendering of math formulas, in machine-readable formats."

Content licensed under Creative Commons Attribution-ShareAlike (CC BY-SA) 4.0 unless otherwise noted; code licensed under GNU General Public License (GPL) 2.0 or later and other open source licenses. By using this site, you agree to the Terms of Use, Privacy Policy, and Code of Conduct. · Wikimedia Foundation · Privacy Policy · Code of Conduct · Terms of Use · Disclaimer · CC-BY-SA · GPL · Credits