Minimal APIs quick reference for .net 8 - Request Logging link leads to incorrect page

[AFayziev]

Description

In the section ASP.NET Core Middleware clicking on Request Logging link leads to a general logging topic for ASP.NET Core 6.0

I believe it should lead to a respective HTTP Logging middleware topic at HTTP logging in ASP.NET Core

Page URL

https://learn.microsoft.com/en-us/aspnet/core/fundamentals/minimal-apis?view=aspnetcore-8.0

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/minimal-apis.md

Document ID

b09824ab-b051-75a1-13b7-b0e281cc46e0

Platform Id

24c01f0e-630a-08a5-698d-9668e1a7b40e

Article author

@wadepickett

Metadata

• ID: b09824ab-b051-75a1-13b7-b0e281cc46e0
• PlatformId: 24c01f0e-630a-08a5-698d-9668e1a7b40e
• Service: aspnet-core
• Sub-service: fundamentals

Related Issues

---

Associated WorkItem - 562467

[wadepickett]

Thanks @AFayziev! You are correct, the link needs to be changed. The link specified a version and that was left in from versions 7 through 9. We will fix it.

[wadepickett]

🤖 AI Triage Summary

📌 Note to community: This is an automated preliminary analysis to help our documentation team quickly review, determine scope and prioritize this issue. This report is not a resolution or answer to your question—it's an internal triage tool that identifies potentially relevant docs, code samples, and versions to look into. A team member will review this issue and respond. Thank you for your contribution!

---

This preliminary assessment report was run by: @wadepickett
Date: 2026-03-17
Issue: 36884
Model: GitHub Copilot

---

Issue Analysis: Request Logging link in Minimal APIs middleware table points to incorrect page

✅ Issue Validation

Status: Valid and actionable

📋 Issue Summary

In the "ASP.NET Core Middleware" table of the Minimal APIs quick reference article, the Request Logging row links to the general ASP.NET Core logging topic (xref:fundamentals/logging/index) instead of the HTTP Logging middleware topic (xref:fundamentals/http-logging/index). This is a mismatch: the description says "Provides support for logging HTTP requests and responses" and the API column references UseHttpLogging, both of which clearly refer to HTTP Logging middleware — not the general logging infrastructure. This incorrect link exists across all version monikers (6.0, 7.0, 8.0, 9.0, and 10.0).

📁 Potentially Affected Files

These files have been identified as possibly related to this issue and may need review.

File	Path	Lines	Section
Main article (10.0)	aspnetcore/fundamentals/minimal-apis.md	53	"ASP.NET Core Middleware" table
Include (9.0)	aspnetcore/fundamentals/minimal-apis/includes/minimal-apis9.md	28	"ASP.NET Core Middleware" table
Include (8.0)	aspnetcore/fundamentals/minimal-apis/includes/minimal-apis8.md	28	"ASP.NET Core Middleware" table
Include (7.0)	aspnetcore/fundamentals/minimal-apis/includes/minimal-apis7.md	28	"ASP.NET Core Middleware" table
Include (6.0)	aspnetcore/fundamentals/minimal-apis/includes/minimal-apis6.md	281	"ASP.NET Core Middleware" table

📝 Preliminary Change Assessment

The following are initial observations for the documentation team to evaluate—not final decisions.

Potential documentation Updates

1. Main article — minimal-apis.md (aspnetcore-10.0 moniker)

File: aspnetcore/fundamentals/minimal-apis.md
Location: Line 53
Type: Link replacement

Current content (line 53):

| [Request Logging](xref:fundamentals/logging/index) | Provides support for logging HTTP requests and responses. | <xref:Microsoft.AspNetCore.Builder.HttpLoggingBuilderExtensions.UseHttpLogging%2A> |

Suggested direction:

| [Request Logging](xref:fundamentals/http-logging/index) | Provides support for logging HTTP requests and responses. | <xref:Microsoft.AspNetCore.Builder.HttpLoggingBuilderExtensions.UseHttpLogging%2A> |

2. Include file — minimal-apis8.md (aspnetcore-8.0 moniker, the version reported in the issue)

File: aspnetcore/fundamentals/minimal-apis/includes/minimal-apis8.md
Location: Line 28
Type: Link replacement

Current content (line 28):

| [Request Logging](xref:fundamentals/logging/index?view=aspnetcore-6.0) | Provides support for logging HTTP requests and responses. | <xref:Microsoft.AspNetCore.Builder.HttpLoggingBuilderExtensions.UseHttpLogging%2A> |

Suggested direction:

| [Request Logging](xref:fundamentals/http-logging/index) | Provides support for logging HTTP requests and responses. | <xref:Microsoft.AspNetCore.Builder.HttpLoggingBuilderExtensions.UseHttpLogging%2A> |

3. Include file — minimal-apis9.md (aspnetcore-9.0 moniker)

File: aspnetcore/fundamentals/minimal-apis/includes/minimal-apis9.md
Location: Line 28
Type: Link replacement (same change as #2 above)

4. Include file — minimal-apis7.md (aspnetcore-7.0 moniker)

File: aspnetcore/fundamentals/minimal-apis/includes/minimal-apis7.md
Location: Line 28
Type: Link replacement (same change as #2 above)

5. Include file — minimal-apis6.md (aspnetcore-6.0 moniker)

File: aspnetcore/fundamentals/minimal-apis/includes/minimal-apis6.md
Location: Line 281
Type: Link replacement (same change as #2 above)

🎯 Suggested Action Plan

For documentation team review

1. Fix the link in all 5 files listed above:

   • Change xref:fundamentals/logging/index (or xref:fundamentals/logging/index?view=aspnetcore-6.0) → xref:fundamentals/http-logging/index
   • The ?view=aspnetcore-6.0 query parameter should also be removed since it pins to an outdated version.

2. Files to update:

   • aspnetcore/fundamentals/minimal-apis.md — Line 53
   • aspnetcore/fundamentals/minimal-apis/includes/minimal-apis8.md — Line 28
   • aspnetcore/fundamentals/minimal-apis/includes/minimal-apis9.md — Line 28
   • aspnetcore/fundamentals/minimal-apis/includes/minimal-apis7.md — Line 28
   • aspnetcore/fundamentals/minimal-apis/includes/minimal-apis6.md — Line 281

3. Verify the rendered link on Microsoft Learn resolves to HTTP logging in ASP.NET Core after publication.

⚠️ Review Considerations

• The incorrect link exists across all supported .NET version monikers (6.0 through 10.0), so all 5 files need to be updated.
• The ?view=aspnetcore-6.0 hardcoded query parameter on many links in the include files (for versions 6.0–9.0) pins readers to the ASP.NET Core 6.0 view even when they are viewing a different version. Consider removing these version pins as a broader cleanup.
• The description column and API column already correctly reference HTTP request/response logging and UseHttpLogging, confirming the link target was simply wrong, not the row content.

🔗 References

• Published article: Minimal APIs quick reference (ASP.NET Core 8.0)
• Current (incorrect) link target: Logging in ASP.NET Core
• Correct link target: HTTP logging in ASP.NET Core
• Source file: aspnetcore/fundamentals/minimal-apis.md
• Issue: dotnet/AspNetCore.Docs#36884