Skip to content

Conversation

entropitor
Copy link

Description

examples is the official openapi standard so it makes sense to support that as well

Copy link

Visit the preview URL for this PR (updated for commit dcf4b63):

https://docusaurus-openapi-36b86--pr1219-c98t0w0f.web.app

(expires Wed, 24 Sep 2025 14:10:48 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: bf293780ee827f578864d92193b8c2866acd459f

@sserrata
Copy link
Member

Hi @entropitor,

Supporting schema examples is a nice addition, but the implementation needs to guard against empty arrays so we don’t drop back to undefined examples.

If a schema or property sets examples: [], the new checks return examples[0] (undefined) instead of falling back to the generator. JSON Schema allows an empty array, so request/response examples (and property values) that previously rendered will now disappear.

@entropitor
Copy link
Author

Thanks for the review. Good catch, I've fixed it 👍

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants