OpenAPI Generator allows generation of API client libraries (SDK generation), server stubs, documentation and configuration automatically given an OpenAPI Spec (v2, v3)
I'd like very much to resolve every $ref inside the definition, since I have a client (I mean the human being) who cannot "follow" the references and needs something easier to read and document.
Is your feature request related to a problem? Please describe.
"Normalizing" models with $ref is good reuse practice
"Denormalizing" model / parameters makes them more readable.
One implementation can be represented as many different models.
"resolveFully" can noramlize a model to be much better compared.
Describe the solution you'd like
The Swagger-Parser has three nice options:
Exposing this transformations as possible "preprocessing" parameters should be cheap "IMHO" :-).
Describe alternatives you've considered
Additional context