zero-rails_openapi
zero-rails_openapi copied to clipboard
Fix examples generation
Examples should have different location and format according to OAS 3.0.
During generating examples for query param, I stepped on the fact, that while example
should be sitting in the schema, examples
should be one level higher. And they are supposed to be a single object, not an array of single key objects.
https://swagger.io/docs/specification/adding-examples/
While I was able to fix the issue and get Swagger UI to show me examples with extended properties like summary fixing specs is a way more complicated issue with RSpec DSL present. Looking forward to some guidance @zhandao.