How To Show The Description Field Of @Schemas witch has a same "ref" field

[Sahalaqj]

Hey! I have a question and hope someone can help! When I user more than one @Schema with same "ref" field ,how can I show the description. Thanks for any answers!

[robin-xyzt-ai]

Have you ever found a solution for this ? I'm bumping into the same problem.

[Sahalaqj]

Have you ever found a solution for this ? I'm bumping into the same problem.

No solution!I think it's a bug or a scene has not been considered

[frantuma]

What you are trying to achieve is something not supported by OAS 2.0 (swagger) or 3.0 and JSON Schema Draft 4: in these versions a schema declaring a $ref has all other fields ignored.

Siblings alongside a defined $ref are part of OAS 3.1, and support for 3.1 is on its way in Swagger Core, but not yet finalized.

[Sahalaqj]

@robin-xyzt-ai Here's the reply, hope help u!

What you are trying to achieve is something not supported by OAS 2.0 (swagger) or 3.0 and JSON Schema Draft 4: in these versions a schema declaring a $ref has all other fields ignored.

Siblings alongside a defined $ref are part of OAS 3.1, and support for 3.1 is on its way in Swagger Core, but not yet finalized.