kogosoftwarellc
[express-openapi] OpenAPI 3.0 - JSONSchema has been released
The README currently states:
OpenAPI 3.0 (beta until the official JSONSchema is released https://github.com/OAI/OpenAPI-Specification/issues/1301)
The schema is now available: https://github.com/OAI/OpenAPI-Specification/tree/master/schemas/v3.0
Linked from: https://github.com/OAI/OpenAPI-Specification/issues/1032#issuecomment-492410088
good catch! open to anyone opening a pr to update the schema and the documentation
@jsdevel What's the status on this update? Thanks
Same as it was in May @MikeyUchiha. We're open to anyone who'd like to submit a PR to update the schema and the documentation.
@jsdevel can you give me some more details on how to "update the schema"? What schema are you referring to? The link above takes you to schema.json but there's nothing like that in this repo.
https://github.com/kogosoftwarellc/open-api/tree/master/packages/openapi-schema-validator
it's likely not as simple as just replacing the json schema file though... we've been basing everything on the schema in that schema validator project i linked to.
openapi-framework uses that schema validator package: https://github.com/kogosoftwarellc/open-api/blob/master/packages/openapi-framework/index.ts
and then every other package assumes the incoming config etc. is all based on the existing v3 schema.
i'm fine proceeding though with the official schema, but it'll likely be a major version bump, and will halt development on the existing schema. not the biggest deal but worth mentioning... we should use the official schema.
You should be able to bump the schema without a major, we did it for https://github.com/stoplightio/spectral and nothing exploded.
Any news on this?
Also, to clarify, what does "beta" mean? If I were to use a 3.0 schema today using express-openapi, what would happen?
