search

carbon-io / carbond

MIT License
2 stars 5 forks source link

Revisit generated descriptions for request body and response body #339

Closed alek-mongodb closed 6 years ago

alek-mongodb commented 6 years ago

Build on #334

nir-jacobson commented 6 years ago

With my suggestion in https://github.com/carbon-io/carbond/issues/340#issuecomment-417813406, Aglio can render multiple request examples per endpoint operation. It should be possible to take a request/response description produced from a schema containing oneOf and spread it across multiple request/response examples, which may be more readable than a single large description.

alek-mongodb commented 6 years ago

It should be possible to take a request/response description produced from a schema containing oneOf and spread it across multiple request/response examples, which may be more readable than a single large description.

Done