Apply suggestions from PR review

Co-authored-by: Tom Dykstra <[email protected]>

Author: mikekistler

aspnetcore/fundamentals/openapi/aspnetcore-openapi.md

@@ -131,11 +131,11 @@ builder.Services.AddOpenApi("v1");
 builder.Services.AddOpenApi("v2");
 ```
 
-Each invocation of <xref:Microsoft.Extensions.DependencyInjection.OpenApiServiceCollectionExtensions.AddOpenApi%2A> can specify its own set of options, so that you can choose to use the same or different transformers / customizations for each OpenApi document.
+Each invocation of <xref:Microsoft.Extensions.DependencyInjection.OpenApiServiceCollectionExtensions.AddOpenApi%2A> can specify its own set of options, so that you can choose to use the same or different customizations for each OpenAPI document.
 
 The framework uses the <xref:Microsoft.AspNetCore.OpenApi.OpenApiOptions.ShouldInclude> delegate method of <xref:Microsoft.AspNetCore.OpenApi.OpenApiOptions> to determine which endpoints to include in each document.
 
-For each document, the <xref:Microsoft.AspNetCore.OpenApi.OpenApiOptions.ShouldInclude> delegate method is called for each endpoint in the application, passing the <xref:Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription> object for the endpoint. The method should return a boolean value indicating whether the endpoint should be included in the document. The <xref:Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription> object contains information about the endpoint, such as the HTTP method, route, and response types, as well as metadata attached to the endpoint via attributes or extension methods.
+For each document, the <xref:Microsoft.AspNetCore.OpenApi.OpenApiOptions.ShouldInclude> delegate method is called for each endpoint in the application, passing the <xref:Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription> object for the endpoint. The method returns a boolean value indicating whether the endpoint should be included in the document. The <xref:Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription> object contains information about the endpoint, such as the HTTP method, route, and response types, as well as metadata attached to the endpoint via attributes or extension methods.
 
 The default implementation of this delegate uses the <xref:Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription.GroupName> field of <xref:Microsoft.AspNetCore.Mvc.ApiExplorer.ApiDescription>, which is set on an endpoint using either the <xref:Microsoft.AspNetCore.Builder.RoutingEndpointConventionBuilderExtensions.WithGroupName%2A> extension method or the <xref:Microsoft.AspNetCore.Routing.EndpointGroupNameAttribute> attribute, to determine which endpoints to include in the document.
 

aspnetcore/fundamentals/openapi/customize-openapi.md

@@ -109,12 +109,12 @@ After all transformers have been applied, the framework makes a pass over the do
 to the `components.schemas` section, replacing them with `$ref` references to the transferred schema.
 This reduces the size of the document and makes it easier to read.
 
-The details of this processing are a bit complicated, and might change in future versions of .NET, but in general:
+The details of this processing are complicated and might change in future versions of .NET, but in general:
 
 * Schemas for class/record/struct types are replaced with a `$ref` to a schema in `components.schemas`
   if they appear more than once in the document.
 * Schemas for primitive types and standard collections are left inline.
-* Schemas for enum types are always replaced with a `$ref` to a schema in to components.schemas.
+* Schemas for enum types are always replaced with a `$ref` to a schema in components.schemas.
 
 Typically the name of the schema in `components.schemas` is the name of the class/record/struct type,
 but in some circumstances a different name must be used.
@@ -128,7 +128,7 @@ that uses the name of the type, but you can replace it with your own implementat
 
 As a simple example of this customization, you might choose to always inline enum schemas.
 This is done by setting <xref:Microsoft.AspNetCore.OpenApi.OpenApiOptions.CreateSchemaReferenceId> to a delegate
-that returns null for enum types, and otherwise returns value from the default implementation.
+that returns null for enum types, and otherwise returns the value from the default implementation.
 The following code shows how to do this:
 
 ```csharp