Change Details

**User Story** As a client developer, I want a unified API for editing article title descriptions that abstracts away the complexity of the underlying description sources **Background** For every Wikipedia except English Wikipedia, the article description included in the [[ https://de.wikipedia.org/api/rest_v1/#/Page%20content/get_page_summary__title_ | page summary ]] is from Wikidata. For English Wikipedia, as described in T256817, it now must come from the short description template in the article. It'd be ideal to have a single API for editing this title description that handles the underlying complexity of either editing Wikidata or English Wikipedia. **Rough Spec Ideas** Add `action=editdescription` with a `text` parameter. For example, clients would make an authenticated request to the action API with the params `action=editdescription&text=Largest city in Pennsylvania` **OR** Treat the `/page/summary` response as "editable" through a `POST` request. This will only work for `description` to start, so if any keys other than `description` are included in the request, it should error out. Authenticated `POST /page/summary/Philadelphia` request with body parameter `description` set to `Largest city in Pennsylvania` **Rough implementation plan** On enwiki, the API would edit the `{{short description}}` or `{{SHORTDESC}}` template in the article's wikitext. If the template doesn't exist in the wikitext, it should be added with the value provided. On all other wikis, edit the Wikidata description for the entity associated with the article by using `action=wbsetdescription`. The edits would be made as if the user who made the authenticated request had made the underlying edits directly.

**User Story** As a client developer, I want a unified API for editing article title descriptions that abstracts away the complexity of the underlying description sources **Background** For every Wikipedia except English Wikipedia, the article description included in the [[ https://de.wikipedia.org/api/rest_v1/#/Page%20content/get_page_summary__title_ | page summary ]] is from Wikidata. For English Wikipedia, as described in T256817, it now must come from the short description template in the article. It'd be ideal to have a single API for editing this title description that handles the underlying complexity of either editing Wikidata or English Wikipedia. **Rough Spec** No strong preference . The client should be able to make an authenticated request with the description text as a parameter and have the short description updated or created in the article itself. **Open questions** Should wikitext be supported? Should it be a MediaWiki REST API, an action API, or something else? **Rough implementation plan** On enwiki, the API would edit the `{{short description}}` or `{{SHORTDESC}}` template in the article's wikitext. If the template doesn't exist in the wikitext, it should be added with the value provided. On all other wikis, edit the Wikidata description for the entity associated with the article by using `action=wbsetdescription`. The edits would be made as if the user who made the authenticated request had made the underlying edits directly.

**User Story** As a client developer, I want a unified API for editing article title descriptions that abstracts away the complexity of the underlying description sources **Background** For every Wikipedia except English Wikipedia, the article description included in the [[ https://de.wikipedia.org/api/rest_v1/#/Page%20content/get_page_summary__title_ | page summary ]] is from Wikidata. For English Wikipedia, as described in T256817, it now must come from the short description template in the article. It'd be ideal to have a single API for editing this title description that handles the underlying complexity of either editing Wikidata or English Wikipedia. **Rough Spec Ideas** Add `action=editdescription` with a `text` parameter. For example,No strong preference . The clients w should be able to make an authenticated request towith the acdescription API with the params `action=edittext as a parameter and have the short description&text=Largest city updated or created in Pennsylvania`the article itself. **OR** Treat the `/page/summary` response as "editable" through a `POST` request. This will only work for `description` to start**Open questions** Should wikitext be supported? Should it be a MediaWiki REST API, so if any keys other than `description` are included in the requestan action API, it should error out. Authenticated `POST /page/summary/Philadelphia` request with body parameter `description` set to `Largest city in Pennsylvania`or something else? **Rough implementation plan** On enwiki, the API would edit the `{{short description}}` or `{{SHORTDESC}}` template in the article's wikitext. If the template doesn't exist in the wikitext, it should be added with the value provided. On all other wikis, edit the Wikidata description for the entity associated with the article by using `action=wbsetdescription`. The edits would be made as if the user who made the authenticated request had made the underlying edits directly.