search

reverb / swagger-spec

This fork of the swagger-spec is intended for 2.0 planning
Other
19 stars 15 forks source link

Default response definitions clutter a spec #122

Closed earth2marsh closed 10 years ago

earth2marsh commented 10 years ago

A typical example:

        default:
          description: Unexpected error
          schema:
            $ref: Error

… seems to be required for every operation. 10 resources with 4 verbs each? That's ~156 extra lines of YAML. If there isn't a more succinct way to express this, perhaps there should be?

webron commented 10 years ago

I imagine the same solution that was used for parameters can be used here, but that's a spec change.

webron commented 10 years ago

Okay, I've misread your suggestion. For now, we'll go with a similar behavior as parameters for externalizing definitions and reusing them.

fehguy commented 10 years ago

added here: https://github.com/reverb/swagger-spec/commit/3cd94260047aa2a24586c5caa0218558d2b1f61a