react to feedback

Author: Rick-Anderson

aspnetcore/fundamentals/openapi/openapi-comments.md

@@ -30,19 +30,11 @@ The following sections describe how to enable and customize XML documentation su
 
 1. Enable XML documentation in the project file:
 
-  :::code language="xml" source="~/fundamentals/openapi/samples/10.x/aspnet-openapi-xml/models/Models.csproj" highlight="7":::
+    :::code language="xml" source="~/fundamentals/openapi/samples/10.x/aspnet-openapi-xml/models/Models.csproj" highlight="7":::
 
 2. Use the [AddOpenApi](xref:Microsoft.Extensions.DependencyInjection.OpenApiServiceCollectionExtensions.AddOpenApi*) method in the service configuration. No configuration is needed, the source generator handles the rest.
 
-  :::code language="csharp" source="~/fundamentals/openapi/samples/10.x/aspnet-openapi-xml/api/Program.cs" highlight="6":::
-
-To include XML documentation files from referenced assemblies, add them as `AdditionalFiles` in the project:
-
-```xml
-<ItemGroup>
-  <AdditionalFiles Include="Path/To/AssemblyDoc.xml" />
-</ItemGroup>
-```
+    :::code language="csharp" source="~/fundamentals/openapi/samples/10.x/aspnet-openapi-xml/api/Program.cs" highlight="6":::
 
 The source generator detects all standard overloads:
 
@@ -74,6 +66,14 @@ The implementation discovers XML files statically at compile-time. The `Addition
 
   :::code language="xml" source="~/fundamentals/openapi/samples/10.x/aspnet-openapi-xml/api/AdditionalFiles.xml" highlight="7":::
 
+To include XML documentation files from referenced assemblies, add them as `AdditionalFiles` in the project:
+
+```xml
+<ItemGroup>
+  <AdditionalFiles Include="Path/To/AssemblyDoc.xml" />
+</ItemGroup>
+```
+
 #### Disabling XML documentation support
 
 To turn off XML documentation integration, remove the source generator from the `Analyzers` item group. Removing the source generator prevents it from being used during compilation.
@@ -121,17 +121,6 @@ The automatic resolution behavior is currently available for XML documentation c
   * Associating the text content to compilation symbols.
   * Developing an understanding of the inheritance hierarchy associated with the types.
 
-
-<!-- ## Frequently Asked Questions
-
-Moved to intro ### What is the OpenAPI XML documentation support feature?
-
-The feature automatically extracts XML documentation comments from code and uses them to populate OpenAPI documentation. API documentation is generated directly from code comments, keeping them in sync. -->
-
-
-
-
-
 XML documentation comments from `ProjectReferences` are automatically resolved and don't require additional configuration.
 
 ### Supported XML documentation tags
@@ -165,10 +154,6 @@ To add examples to documentation, use the [`<example>`](/dotnet/csharp/language-
 /// <param name="id" example="42">The unique identifier</param>
 ```
 
-<!-- move FAQ to topic --> zzz
-
-
-
 <a name="download10"></a>
 
 ## Download and run the API sample