Kyle-Ye
(Kyle)
1
I’m not sure if this is the best place to submit such feedback, but the relevant Github repository has closed the Issue submission portal, so I try to give feedback here.
GitHub - discourse/discourse_api_docs: Discourse API Documentation
The openapi.json file hosted at GitHub - discourse/discourse_api_docs: Discourse API Documentation is actually not a valid openapi file.
See more info here Discourse openapi.json generate issue · Issue #277 · mattpolzin/OpenAPIKit · GitHub
TL,DR 
The items key for an array schema "MUST be a valid JSON Schema" (json-schema.org/draft/2020-12/json-schema-core.html#section-10.3.1.2-1) and a JSON Schema "MUST be an object or a boolean" (json-schema.org/draft/2020-12/json-schema-core.html#section-4.3-2). Because this part of the OpenAPI Document is governed by JSON Schema rules, they likely don’t bother mentioning too many of those rules inside the OpenAPI specification itself.
إعجاب واحد (1)
Kyle-Ye
(Kyle)
2
Discourse’s openapi.json is generated by a tool named rswag
Maybe this is an upstream issue. And when upstream fix it, we should upgrade the dependency version and update the corresponding doc files.
إعجابَين (2)
blake
(Blake Erickson)
3
PR above ^ was actually addressed downstream here:
إعجاب واحد (1)