Skip to content

Conversation

@jwulf
Copy link

@jwulf jwulf commented Sep 23, 2025

Description

This PR adds display of the format for oneOf schemas with a primitive arm, in line with the display for the field when it is a direct property.

Motivation and Context

oneOf schemas with a primitive arm do not display the format, but display the primitive type only. This impacts enums and specific format strings like date-time. See this issue for more context and examples.

How Has This Been Tested?

This change has been tested by manually verifying the change in output display.

Screenshots (if appropriate)

Example of the output without this patch:

Screenshot 2025-09-24 at 10 49 22 AM

This PR correctly displays the format.

Example of the output when this patch is applied:

Screenshot 2025-09-24 at 10 50 04 AM

Types of changes

  • New feature (non-breaking change which adds functionality)

Checklist

  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes if appropriate.
  • All new and existing tests passed.

@GautierBlandin
Copy link

Would love this to be merged, running into the same issue.

@github-actions
Copy link

github-actions bot commented Oct 7, 2025

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

https://docusaurus-openapi-36b86--pr1230-2kwerttl.web.app

(expires Thu, 06 Nov 2025 16:12:49 GMT)

🔥 via Firebase Hosting GitHub Action 🌎

Sign: bf293780ee827f578864d92193b8c2866acd459f

@sserrata sserrata self-assigned this Nov 11, 2025
@sserrata sserrata added the reviewing 👀 Undergoing manual audit to determine if issue should still be active label Nov 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

reviewing 👀 Undergoing manual audit to determine if issue should still be active

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants