diff --git a/aspnetcore/release-notes/aspnetcore-10/includes/enhance-validation-classes-records.md b/aspnetcore/release-notes/aspnetcore-10/includes/enhance-validation-classes-records.md new file mode 100644 index 000000000000..13b1db1b8a63 --- /dev/null +++ b/aspnetcore/release-notes/aspnetcore-10/includes/enhance-validation-classes-records.md @@ -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)! \ No newline at end of file diff --git a/aspnetcore/release-notes/aspnetcore-10/includes/formdata-enum-parameters.md b/aspnetcore/release-notes/aspnetcore-10/includes/formdata-enum-parameters.md new file mode 100644 index 000000000000..c3f5be6a2cf6 --- /dev/null +++ b/aspnetcore/release-notes/aspnetcore-10/includes/formdata-enum-parameters.md @@ -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)! diff --git a/aspnetcore/release-notes/aspnetcore-10/includes/upgrade-microsoft-openapi-2.md b/aspnetcore/release-notes/aspnetcore-10/includes/upgrade-microsoft-openapi-2.md new file mode 100644 index 000000000000..a34020114280 --- /dev/null +++ b/aspnetcore/release-notes/aspnetcore-10/includes/upgrade-microsoft-openapi-2.md @@ -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. diff --git a/aspnetcore/release-notes/aspnetcore-10/includes/xml-comment-generator.md b/aspnetcore/release-notes/aspnetcore-10/includes/xml-comment-generator.md index 91c864b39ea4..935ecb21f777 100644 --- a/aspnetcore/release-notes/aspnetcore-10/includes/xml-comment-generator.md +++ b/aspnetcore/release-notes/aspnetcore-10/includes/xml-comment-generator.md @@ -27,4 +27,9 @@ This configuration is done with directives in the project build file. The follow ``` -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. +