The description API will be implemented by page content service. We need to add PCS cluster as envoy upstream and add a route match for /page/[^/]/description$ routed to PCS.
All the regular envoy features should be applied - ratelimit, strip cookies, etc.
The path should be rewritten in a similar fashion to feed endpoints.
| Project | Branch | Lines +/- | Subject | |
|---|---|---|---|---|
| operations/deployment-charts | master | +62 -7 | Expose /page/descrtion API |
| Status | Subtype | Assigned | Task | ||
|---|---|---|---|---|---|
| Stalled | None | T192838 Magic word on English WP [tracking] | |||
| Open | None | T257588 Improve the integration of description and label fields with other Wikimedia projects | |||
| Open | None | T248457 Fully terminate use of Wikidata item descriptions as short article descriptions for English Wikipedia articles | |||
| Resolved | Dbrant | T256817 [EPIC] Replace Wikidata descriptions on enwiki with local descriptions | |||
| Open | None | T259617 Article description editing API | |||
| Resolved | None | T262498 Expose page description API in gateway |
Change 630657 had a related patch set uploaded (by Ppchelko; owner: Ppchelko):
[operations/deployment-charts@master] Expose /page/descrtion API
Change 630657 merged by jenkins-bot:
[operations/deployment-charts@master] Expose /page/descrtion API
We didn't discuss this, but... if this is going to be mounted in the /core/v1 namespace, that means we're supporting it for backwards compatibility.
I'm OK with that. I'd be surprised if we made major changes here.
But in the future, let's mount new API endpoints in a temporary or development namespace, like /foo/v0, until we've shaken out any design issues with client teams.
@Pchelolo I can't make this work for mediawiki routes; it seems to work for language-specific projects like wikivoyage and wikibooks. I'll see if there are other projects that don't have it. I don't think they're important; I don't even know if there's a way to view those descriptions. But we should consciously choose not to use them.