In my project, in order to keep the api yaml clean I use a lot of external references, for example:
ApiResponse:
allOf:
- $ref: 'includes/apiresponse.yaml#/GenericResponse'
Would it possible to generate, along with the code, also a yaml that replaces the $refs with the actual snippet? I'm currently using the openapi maven plugin, but maybe maven already has some other plugin to accomplish that.