Section 5.2.5 changes

[webron]

Issue by quasipedia from Sunday Mar 02, 2014 at 00:44 GMT
Originally opened as https://github.com/wordnik/swagger-docs/issues/5

---

This has been extensively discussed here. But to make a quick summary, my proposal is:

1. deprecate type from the main body of the object.
2. rename responseMessages to responses.
3. have in each response code (the HTTP status, inclusive the ones in the 2xx family - if any), message (an informational message that the client can store and reuse for its GUI but that will not be transmitted at each response) and model (omitting this will be equivalent to "model": "void", i.e. a response without body).

I highlighted the reasons why I feel this is a better solution in the linked issue.

[webron]

Implemented in Swagger 2.0.