-
Notifications
You must be signed in to change notification settings - Fork 3.9k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Add support for examples in OpenAPI block #2314
Conversation
The latest updates on your projects. Learn more about Argos notifications ↗︎
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
xxxxxxxxxx
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
IMO it can't be merged in the current state and it requires more work:
- Properly support non-primitive values?
- should we represent with
JSON.stringify
? If yes, it'll not work well for XML/etc API - should we skip non-primitives using
typeof schema.example === 'string' || typeof schema.example === 'number' || typeof schema.example === 'boolean'
?
- should we represent with
- Should we handle
examples
as well by selecting the first example or the one matching the media-type?
@SamyPesse this is blocking for an ICP customer going live with their API docs. I think Vib made the requested changes. Can we get it to move? |
Same description as #2313