Skip to content

WN: 10prev7 OpenAPI #35925

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

Merged
merged 8 commits into from
Aug 12, 2025
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
### Enhanced validation for classes and records

Validation attributes can now be applied to both classes and records with consistent code generation and validation behavior. This enhancement improves flexibility when designing models using records in ASP.NET Core apps.

Community contribution: Thanks to [@marcominerva](https://github.com/marcominerva)!
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
### Form data enum parameters use actual enum type in OpenAPI

Form data parameters in MVC controller actions now generate OpenAPI metadata using the actual enum type instead of defaulting to string.

Community contribution: Thanks to [@ascott18](https://github.com/ascott18)!
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
### Upgrade Microsoft.OpenApi to 2.0.0

The [`Microsoft.OpenApi`](https://www.nuget.org/packages/Microsoft.OpenApi/) library used for OpenAPI document generation in ASP.NET Core has been upgraded to version 2.0.0 (GA).
With this update to the GA version, no further breaking changes are expected in OpenAPI document generation.
Original file line number Diff line number Diff line change
Expand Up @@ -27,4 +27,9 @@ This configuration is done with directives in the project build file. The follow
</Target>
```

We expect to include XML comments from a selected set of assemblies in the shared framework in future previews, to avoid the need for this configuration in most cases.
We expect to include XML comments from a selected set of assemblies in the shared framework in future previews to avoid the need for this configuration in most cases.

#### Unified handling of documentation IDs in OpenAPI XML comment generator

XML documentation comments from referenced assemblies are correctly merged even when their documentation IDs include return type suffixes. As a result, all valid XML comments are reliably included in generated OpenAPI documentation, improving documentation accuracy and completeness for APIs using referenced assemblies.