Field "description" values are usurped by the schema's definition description (used via Redoc)

[davetransom]

Field "description" values are usurped by the schema's definition description (used via Redoc)

[MikeRalphson]

By default swagger2openapi follows the OpenAPI 2.0 / 3.0 spec which says that all other properties which are siblings to a $ref are ignored.

There is an option (CLI and programmatic) called refSiblings which defines the mode to handle $ref's with sibling properties, the valid values are remove (the default), preserve, and allOf, the last of which wraps the $ref and the sibling properties into an allOf array.

I don't know if Redoc specifies or exposes this option, or even if it uses a version of swagger2openapi recent enough to have it. Maybe @RomanHotsiy knows off-hand?

[MikeRalphson]

refSiblings was introduced in swagger2openapi v5.0.0, and Redoc uses v7.0.6 so it could make use of this feature. https://github.com/Redocly/redoc/search?q=refSiblings shows it doesn't alter the default.

[RomanHotsiy]

@davetransom open an issue in Redoc repo plz. I believe we don't use refSiblings flag.

@MikeRalphson I think you can close this.

[MikeRalphson]

Thanks both!