vacuum is the worlds fastest OpenAPI 3, OpenAPI 2 / Swagger linter and quality analysis tool. Built in go, it tears through API specs faster than you can think. vacuum is compatible with Spectral rulesets and generates compatible reports.
given
"400":
$ref: ../../_shared/common.yaml#/components/responses/400-BadRequest
redocly will produce
'401':
$ref: '#/components/responses/401-Unauthorized'
vs yours is expanding all
that can generate giantic files,
this could be mitigated by doing same as redocly . and given name conflict doing (here) 401-Unthorize_X
given "400": $ref: ../../_shared/common.yaml#/components/responses/400-BadRequest redocly will produce '401': $ref: '#/components/responses/401-Unauthorized' vs yours is expanding all
that can generate giantic files,
this could be mitigated by doing same as redocly . and given name conflict doing (here) 401-Unthorize_X
could also have an option for full expend
this is low priority , requirement