WN: 10prev7 OpenAPI (#35925)

* WN: 10prev7 OpenAPI

* Removed dupe openAPI 2 .md file

* Fixed link

* revert respoinseDescProducesResponseType.md changes since a different PR is handling that

* Added enahnced validation

* Update aspnetcore/release-notes/aspnetcore-10/includes/enhance-validation-classes-records.md

Co-authored-by: Luke Latham <[email protected]>

* Update aspnetcore/release-notes/aspnetcore-10/includes/upgrade-microsoft-openapi-2.md

Co-authored-by: Luke Latham <[email protected]>

* Update aspnetcore/release-notes/aspnetcore-10/includes/xml-comment-generator.md

Co-authored-by: Luke Latham <[email protected]>

---------

Co-authored-by: Luke Latham <[email protected]>

Author: wadepickett

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)!

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)!

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.

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
 </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.  
+