Starting with 2.8.6 OAS 3.1 broken enums

[crazyav1]

Starting from version 2.8.6 with OAS 3.1 enums and examples are displayed broken
2.8.6+

2.8.5:

[Mattias-Sehlstedt]

Hi,

Springdoc 2.8.6 changed the default OpenAPI specification version from 3.0 to 3.1, this makes swagger-ui change how it renders the specification. You can see it here https://editor-next.swagger.io/ when you in the top left can select File -> Load example -> OpenAPI 3.(1/0) Petstore. And if you go to the 3.1 version you will see that its enum rendering will align with what you show above.

If you prefer the previous way of displaying a specification, then you can set springdoc.api-docs.version=openapi_3_0 in your properties.

[crazyav1]

@Mattias-Sehlstedt I do not understand your comment, it was already 3.1 for me before. So you are saying it is intentional change to downgrade visually for 3.1? does not make any sence. Partiularry redundant part "#0=" etc

[Mattias-Sehlstedt]

If not tied to the specification version, then it is tied to the swagger-ui bump in 2.8.6, and yes the 3.1 rendering is a downgrade with regards to enum display and oneOf/anyOf and objects in general.

This is for example with 3.0

And this with 3.1

But to summarize, the issue is not tied to springdoc-openapi, so any issues with this display format should be raised in swagger-ui.