De-duplicate documentation on parameter binding

[mikekistler]

Description

Problem

For ASP.NET Core releases 8-10, the same content on parameter binding appears in two different places. It appears in the "Parameter binding" article (this one) and also in the "Parameter binding" section of the Minimal APIs quick reference:

The content in both places comes from the same source:

aspnetcore/fundamentals/minimal-apis/includes/parameter-binding8-10.md

There are several problems with this:

• duplicate content can confuse readers (Why does this appear in two places? Are there differences?)
• The shear bulk of this content can be daunting to readers
• Because the same content is used in a top-level article and in a section within an article, the headings tags used (h3 and above) don't get picked up and displayed in the "In this article" nav normally shown in the right hand pane.

Desired solution

• The "Parameter binding" section of "Minimal APIs quick reference" should be changed to a brief summary of the full content (1/10 the size or less) with a link to the full article.
• The headings in the "Parameter binding" article should be adjusted so that they generate a proper "In this article" nav in the right hand pane.

Page URL

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

Content source URL

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

Document ID

a09dcf06-a685-e5b8-0ce4-a4e53c57a9fd

Platform Id

c0db1758-e9b3-c215-4fe4-e9a63d9cb76e

Article author

@wadepickett

Metadata

• ID: a09dcf06-a685-e5b8-0ce4-a4e53c57a9fd
• PlatformId: c0db1758-e9b3-c215-4fe4-e9a63d9cb76e
• Service: aspnet-core
• Sub-service: fundamentals

Related Issues

---

Associated WorkItem - 502082

[wadepickett]

Thanks for catching this @mikekistler!

[wadepickett]

AI Analysis and Action Plan

This AI generated reports is intended to help Improve AI Handling of This Issue.

Using:
Model: Claude Sonnet 3.7
Prompt Instructions: Verify-issue-set-course-of-action_v.02

---

Issue Summary

There is duplicate content about parameter binding appearing in two different places in the ASP.NET Core documentation, which can cause confusion for readers.

---

Detailed Analysis

The parameter binding documentation appears in:

• The "Parameter binding" article: /aspnet/core/fundamentals/minimal-apis/parameter-binding
• The "Minimal APIs quick reference" article in the parameter binding section

Both places include the same content from a single source file:
aspnetcore/fundamentals/minimal-apis/includes/parameter-binding8-10.md

Problems Caused by Duplicate Content

• Readers may be confused by seeing the same content in two different places
• The bulk of repeated content is overwhelming
• The heading structure doesn't work properly in both contexts, affecting the "In this article" navigation panel

---

Files to Modify

Parameter Binding Article

• File: aspnetcore/fundamentals/minimal-apis/parameter-binding.md
• Current Implementation: Includes the parameter-binding8-10.md include file directly

Minimal APIs Quick Reference Article

(Not shown in provided files, but referenced in the issue)

• Needs modification to replace the full parameter binding content with a brief summary and link

---

Required Changes

For the Parameter Binding Article

• Keep the full content but adjust heading levels to ensure proper navigation
• Line 16 contains: [!INCLUDE parameter-binding]
• No changes needed to this file structure, but headings in the include file might need adjustment

For the Minimal APIs Quick Reference Article

• Replace the include statement that adds the full content with a brief summary
• Add a prominent link to the dedicated Parameter binding article
• This would reduce the duplicate content significantly

---

Technical Details

• Both files target .NET versions 7.0 and later (monikerRange: '>= aspnetcore-7.0')
• The Parameter binding article is actively maintained (last updated: 10/22/2025 according to the metadata)
• The included file (parameter-binding8-10.md) is extensive, with over 450 lines of documentation

---

Recommendation

Proceed with implementing the changes as described in the issue:

1. Keep the full parameter binding documentation in the dedicated article
2. Create a brief summary (1/10 the size or