smallrye-open-api & OpenAPI schema versions

[dhoffer]

How does smallrye-openapi coordinate its support for the various OpenAPI version spec versions. E.g. I understand that smallrye-openapi's default OpenAPI version is 3.1.0. But it seems you also support 3.0.3 if specified. Do you also support older versions?

So how do the smallrye-openapi's versions map to supported OpenAPI spec versions?

Is there a table someplace that says how these two versions are supported/related?

One reason I ask is that we have found that the 3.1.0 schema is not handled well by the Swagger UI component, its too slow to be acceptable. I understand they know it's an issue but not sure when/if they will address it. However 3.0.3 is fine.

So will smallrye-openapi continue to support 3.0.3 indefinitely? Or is there a smallrye-openapi version that will stop supporting 3.0.3?

[MikeEdgar]

So will smallrye-openapi continue to support 3.0.3 indefinitely? Or is there a smallrye-openapi version that will stop supporting 3.0.3?

@dhoffer there are no plans to drop 3.0.x any time soon. The pre-3.0 Swagger 2 versions are not supported.

Generally:
smallrye-openapi pre-4.0: OpenAPI 3.0.x only
smallrye-openapi 4.0+: OpenAPI 3.0.x and 3.1.x, with 3.1.0 being the default