Why there no response reference within current implementation?

[ycherniavskyi]

While I try to somehow pass response reference to responses property of operation (from spec I could see that Responses Object could be Response Object or Reference Object), I understand that there no such possibility for now (or I completely miss something).

Is it an intentional limitation?

Or maybe there some other way to implement the next functionality:

...
        "responses": {
         ...
          "500": {
            "$ref": "#/components/responses/500Error"
          }
        },
...

[mbuhot]

Hi @ycherniavskyi, can you share what you've tried so far? I suspect it is supported by the underlying data structures, but not the newer high level DSL.

It looks like the OperationBuilder.build_responses/2` function doesn't handle references.

Would you mind creating a PR to add another clause to that function to handle references similar to how they are handled for parameters?

[ycherniavskyi]

For now, I am going with direct %Operation{} structs usage. But within the next refactoring iteration, I am planning to return to ControllerSpecs-style Operation, so I will try to create such PR then.