Swagger-UI 5.1.0: Example Value box displayed for Response Object with only description.

[Teraskull]

Q&A (please complete the following information)

• Swagger-UI version: 5.1.0
• Swagger/OpenAPI version: OpenAPI 3.1

Looks similar to #5453.
Does not happen on Swagger-UI 4.

If I have a response object like this, with only description, it shows an Example Value box with "string" value:

401:
    description: Unauthorized

On Swagger-UI 4 only the description is visible, without the Example Value box.

Not sure if this is a regression or an intended feature.

[Teraskull]

Any workarounds? Seems like a regression to me

[Teraskull]

@char0n this change is undocumented?

[char0n]

I'd say it's a regression. If the Response Object.content field is not defined or is defined but doesn't contain schema we shouldn't render anything; except for the case where example or examples fields are explicitly defined on Media Type Object.

[bweben]

responses:
        "200":
          description: "OK"
          content:
            '*/*':
              schema:
                $ref: "#/components/schemas/SchemaObjectDefinition"

As I understand you @char0n correctly, this should display an example value and not just "string"?
Sadly, we still have the issue that "string" is displayed instead of the Object as the example. The same example works the same on here https://editor.swagger.io/.
We use the version 5.11.9.