Description
To complete our implementation of interactive documentation and support our long term vision of validated specs, we need to define and document specific endpoint responses as JSON schemas. Other tasks (T375530: Define and store MediaWiki REST API ‘page’ endpoint responses as JSON schemas, T379705: Create JSON schema definition for MediaWiki REST API 'transform' endpoints) covered most of the endpoints defined in core. This task covers the remaining endpoints.
Problem statement
We need JSON schema representations of our response bodies so that we can build and test validation against them.
Conditions of acceptance
Define response schemas for the following endpoints (200 only):
- page/{title}/history/counts/{type} (PageHistoryCountHandler)
- revision/{from}/compare/{to} (CompareHandler)
- revision/{id}/html (RevisionHTMLHandler)
- revision/{id}/with_html (RevisionHTMLHandler)
- revision/{id}/bare (RevisionSourceHandler)
- revision/{id} (RevisionSourceHandler)
- search (OpenSearchDescriptionHandler)
- /discovery (DiscoveryHandler)
- /module/{module} (ModuleSpecHandler)
- /module/{module}/{version} (ModuleSpecHandler)