[express-openapi] OpenAPI 3.0 - JSONSchema has been released

[intelliot]

The README currently states:

OpenAPI 3.0 (beta until the official JSONSchema is released OAI/OpenAPI-Specification#1301)

The schema is now available:
https://github.com/OAI/OpenAPI-Specification/tree/master/schemas/v3.0

Linked from:
OAI/OpenAPI-Specification#1032 (comment)

[jsdevel]

good catch! open to anyone opening a pr to update the schema and the documentation

[MikeyUchiha]

@jsdevel What's the status on this update? Thanks

[jsdevel]

@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.

[jameskhedley]

@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.

[jsdevel]

https://github.com/kogosoftwarellc/open-api/tree/master/packages/openapi-schema-validator

[jsdevel]

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.

[jsdevel]

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.

[philsturgeon]

You should be able to bump the schema without a major, we did it for https://github.com/stoplightio/spectral and nothing exploded.

[NathanHazout]

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?