The Wikimedia OpenAPI Linter requires that each operation (unique method and path combination) have an operation ID, so the MediaWiki REST API OpenAPI docs should include operation IDs. These IDs can be generated using the operation summary instead of being manually created. IDs do not need to be translatable.
From the on-wiki docs:
"Operation identifier is a string that uniquely identifies an operation.
- OpenAPI field: paths.[path].[operation].operationId
- This field is required for every operation in the OpenAPI description.
- This field must have a unique value.
When defining the operationId field, follow common programming naming conventions. One way to create this identifier is to convert the operation summary into a single word in camel case, snake case, or similar - for example, "verifyCustomer", "getPetById"."
Example:
...
"paths": {
"/v1/linkrecommendations/{project}/{domain}/{page_title}": {
"get": {
"description": "Returns a set of possible links that can be added to improve an article on Wikipedia.",
"operationId": "getLinkRecommendations",
...