Skip to content

v11 update: OpenAPI schemas better match ASP.NET Core behavior - #37849

Merged
guardrex merged 6 commits into
dotnet:mainfrom
SkyDevLab:docs/37703-openapi-schemas-behavior
Oct 22, 2026
Merged

guardrex merged 6 commits into
dotnet:mainfrom
SkyDevLab:docs/37703-openapi-schemas-behavior

Conversation

@SkyDevLab

@SkyDevLab SkyDevLab commented Oct 13, 2026 •

Copy link
Copy Markdown
Contributor

Fixes #37703

Documents non-body enum parameter naming, ArrayOf schema reference ID composition, and multiple Produces declarations per status code.


Internal previews

File Preview link
aspnetcore/fundamentals/openapi/customize-openapi.md Learn preview
aspnetcore/fundamentals/openapi/include-metadata.md Learn preview

Build report

@SkyDevLab
SkyDevLab requested a review from guardrex as a code owner October 13, 2026 18:35
@guardrex guardrex self-assigned this Oct 13, 2026

@guardrex guardrex left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Just a few updates here.

Don't worry about the article dates. They're close enough.

Comment thread aspnetcore/fundamentals/openapi/customize-openapi.md Outdated
Comment thread aspnetcore/fundamentals/openapi/customize-openapi.md Outdated
Comment thread aspnetcore/fundamentals/openapi/customize-openapi.md Outdated
Comment thread aspnetcore/fundamentals/openapi/include-metadata.md Outdated
Comment thread aspnetcore/fundamentals/openapi/include-metadata.md Outdated

This comment was marked as resolved.

@guardrex

This comment was marked as resolved.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

The focused documentation updates address prior feedback and have no unresolved findings.

No open issues 🎉

3 resolved since last review

Review effort: Balanced

@guardrex
guardrex requested a review from Youssef1313 October 20, 2026 17:30
@guardrex

Copy link
Copy Markdown
Collaborator

@SkyDevLab ... A merge conflict appeared on this one.

@SkyDevLab

Copy link
Copy Markdown
Contributor Author

@guardrex Resolved the merge conflict with main! The branch is up-to-date, clean, and ready to merge. Thanks!

@guardrex guardrex left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🎉

@guardrex
guardrex enabled auto-merge (squash) October 22, 2026 16:57
@guardrex
guardrex merged commit b784dd9 into dotnet:main Oct 22, 2026
8 checks passed
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.

v11 update: OpenAPI schemas better match ASP.NET Core behavior

3 participants