human edits

Author: gewarren

docs/core/compatibility/8.0.md

@@ -18,6 +18,7 @@ If you're migrating an app to .NET 8, the breaking changes listed here might aff
 | [ConcurrencyLimiterMiddleware is obsolete](aspnet-core/8.0/concurrencylimitermiddleware-obsolete.md) | Source incompatible |
 | [Custom converters for serialization removed](aspnet-core/8.0/problemdetails-custom-converters.md)   | Behavioral change   |
 | [Forwarded Headers Middleware ignores X-Forwarded-* headers from unknown proxies](aspnet-core/8.0/forwarded-headers-unknown-proxies.md) | Behavioral change   |
+| [HTTP logging middleware requires AddHttpLogging()](aspnet-core/8.0/httpLogging-addhttplogging-requirement.md) | Behavioral change |
 | [ISystemClock is obsolete](aspnet-core/8.0/isystemclock-obsolete.md)                                 | Source incompatible |
 | [Minimal APIs: IFormFile parameters require anti-forgery checks](aspnet-core/8.0/antiforgery-checks.md) | Behavioral change   |
 | [Rate-limiting middleware requires AddRateLimiter](aspnet-core/8.0/addratelimiter-requirement.md)    | Behavioral change   |

docs/core/compatibility/aspnet-core/8.0/httpLogging-addhttplogging-requirement.md

@@ -1,9 +1,9 @@
 ---
-title: "Breaking change: HTTP logging middleware requires AddHttpLogging"
-description: Learn about the breaking change in ASP.NET Core 8.0 where HTTP logging middleware now requires AddHttpLogging to be called on app startup.
-ms.date: 11/14/2023
+title: "Breaking change: HTTP logging middleware requires AddHttpLogging()"
+description: Learn about the breaking change in ASP.NET Core 8.0 where HTTP logging middleware now requires AddHttpLogging() to be called.
+ms.date: 09/29/2025
 ---
-# HTTP logging middleware requires AddHttpLogging
+# HTTP logging middleware requires AddHttpLogging()
 
 ASP.NET Core HTTP logging middleware has been updated with extra functionality. The middleware now requires services registered with <xref:Microsoft.Extensions.DependencyInjection.HttpLoggingServicesExtensions.AddHttpLogging%2A>.
 
@@ -13,20 +13,11 @@ ASP.NET Core 8.0
 
 ## Previous behavior
 
-Previously, HTTP logging could be used by calling only <xref:Microsoft.AspNetCore.Builder.HttpLoggingBuilderExtensions.UseHttpLogging%2A>:
-
-```csharp
-var builder = WebApplication.CreateBuilder(args);
-
-var app = builder.Build();
-app.UseHttpLogging();
-app.MapGet("/", () => "Hello World!");
-app.Run();
-```
+Previously, you could call just `app.UseHttpLogging();` to activate HTTP logging.
 
 ## New behavior
 
-If <xref:Microsoft.Extensions.DependencyInjection.HttpLoggingServicesExtensions.AddHttpLogging%2A> is not called on app startup, ASP.NET Core throws an informative error:
+Starting in .NET 8, if you don't also call <xref:Microsoft.Extensions.DependencyInjection.HttpLoggingServicesExtensions.AddHttpLogging%2A>, an error is raised:
 
 > System.InvalidOperationException: Unable to resolve service for type 'Microsoft.Extensions.ObjectPool.ObjectPool`1[Microsoft.AspNetCore.HttpLogging.HttpLoggingInterceptorContext]' while attempting to activate 'Microsoft.AspNetCore.HttpLogging.HttpLoggingMiddleware'.
 
@@ -36,24 +27,12 @@ This change is a [behavioral change](../../categories.md#behavioral-change).
 
 ## Reason for change
 
-Additional features were added to the HttpLogging middleware which are registered (and configurable) via the <xref:Microsoft.Extensions.DependencyInjection.HttpLoggingServicesExtensions.AddHttpLogging%2A> method.
+Additional features were added to the HttpLogging middleware that are registered (and configurable) via the <xref:Microsoft.AspNetCore.Telemetry.HttpLoggingServiceExtensions.AddHttpLogging*> method.
 
 ## Recommended action
 
-Ensure that <xref:Microsoft.Extensions.DependencyInjection.HttpLoggingServicesExtensions.AddHttpLogging%2A> is called at application startup.
-
-For example:
-
-```csharp
-var builder = WebApplication.CreateBuilder(args);
-builder.Services.AddHttpLogging();
-
-var app = builder.Build();
-app.UseHttpLogging();
-app.MapGet("/", () => "Hello World!");
-app.Run();
-```
+Call `services.AddHttpLogging()` during host construction.
 
 ## Affected APIs
 
-- <xref:Microsoft.AspNetCore.Builder.HttpLoggingBuilderExtensions.UseHttpLogging%2A?displayProperty=fullName>
+None.

docs/core/compatibility/toc.yml

@@ -336,7 +336,7 @@ items:
                 href: aspnet-core/8.0/problemdetails-custom-converters.md
               - name: Forwarded Headers Middleware ignores X-Forwarded-* headers from unknown proxies
                 href: aspnet-core/8.0/forwarded-headers-unknown-proxies.md
-              - name: HTTP logging middleware requires AddHttpLogging
+              - name: HTTP logging middleware requires AddHttpLogging()
                 href: aspnet-core/8.0/httpLogging-addhttplogging-requirement.md
               - name: ISystemClock is obsolete
                 href: aspnet-core/8.0/isystemclock-obsolete.md