WN10.P4 edit pass for XML comment gen improvements (#35420)

* edit pass for xml comment gen improvements

* minor tweak

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

Co-authored-by: Copilot <[email protected]>

* Update aspnetcore-10.0.md

* Apply suggestions from code review

Co-authored-by: Rick Anderson <[email protected]>

* Update aspnetcore/release-notes/aspnetcore-10.0.md

* reformat xml lines to make them shorter

* Update aspnetcore/release-notes/aspnetcore-10.0.md

---------

Co-authored-by: Copilot <[email protected]>
Co-authored-by: Rick Anderson <[email protected]>

Author: 3 people

aspnetcore/release-notes/aspnetcore-10.0.md

@@ -53,6 +53,8 @@ This section describes new features for OpenAPI.
 
 [!INCLUDE[](~/release-notes/aspnetcore-10/includes/webapiaotTemplateAddedOpenAPI.md)]
 
+[!INCLUDE[](~/release-notes/aspnetcore-10/includes/xml-comment-generator.md)]
+
 [!INCLUDE[](~/release-notes/aspnetcore-10/includes/OpenApiSchemasInTransformers.md)]
 
 ## Authentication and authorization

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

@@ -1,12 +1,12 @@
-## Improvements to XML comment generator
+### Improvements to the XML comment generator
 
-<!-- https://github.com/dotnet/aspnetcore/pull/61145 -->
+XML comment generation handles complex types in .NET 10 better than earlier versions of .NET.
 
-<!-- it should throw fewer build errors now.
-- It should also work with the Identity API XML comments but I haven't verified that.
-  - Maybe update docs about failure mode. -->
+* It produces accurate and complete XML comments for a wider range of types.
+* It handles more complex scenarios.
+* It gracefully bypasses processing for complex types that cause build errors in earlier versions.
 
-The XML comment generator has been enhanced to better handle complex types. In conjunction, the generator now gracefully bypasses processing for complex types that previously caused build errors. Taken together, these changes improve the robustness of XML comment generation but change the failure mode for certain scenarios from build errors to missing metadata.
+These improvements change the failure mode for certain scenarios from build errors to missing metadata.
 
 In addition, XML doc comment processing can now be configured to access XML comments in other assemblies. This is useful for generating documentation for types that are defined outside the current assembly, such as the `ProblemDetails` type in the `Microsoft.AspNetCore.Http` namespace.
 
@@ -15,14 +15,16 @@ This configuration is done with directives in the project build file. The follow
 ```xml
 <Target Name="AddOpenApiDependencies" AfterTargets="ResolveReferences">
   <ItemGroup>
-    <!-- Include XML documentation from Microsoft.AspNetCore.Http.Abstractions to get metadata for ProblemDetails -->
+  <!-- Include XML documentation from Microsoft.AspNetCore.Http.Abstractions
+    to get metadata for ProblemDetails -->
     <AdditionalFiles
-          Include="@(ReferencePath->'%(RootDir)%(Directory)%(Filename).xml')"
-          Condition="'%(ReferencePath.Filename)' == 'Microsoft.AspNetCore.Http.Abstractions'"
+          Include="@(ReferencePath->'
+            %(RootDir)%(Directory)%(Filename).xml')"
+          Condition="'%(ReferencePath.Filename)' ==
+           'Microsoft.AspNetCore.Http.Abstractions'"
           KeepMetadata="Identity;HintPath" />
   </ItemGroup>
 </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.
-<!--[!INCLUDE[](~/release-notes/aspnetcore-10/includes/xml-comment-generation.md)] -->