Invalid moniker syntax in ASP.NET Core documentation

[FelixEckl]

Description

Page URL

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

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/configuration/options.md

Document ID

dc7e3449-650b-d117-5eac-69e5ccb250cb

Platform Id

c815d451-e2c8-0cf1-5862-03b12dd0392a

Article author

@tdykstra

Metadata

• ID: ed39cb0e-aa85-8bba-ffb4-859b56a60723
• PlatformId: c815d451-e2c8-0cf1-5862-03b12dd0392a
• Service: aspnet-core
• Sub-service: fundamentals
• I already opened an PR for this: Fix moniker syntax for ASP.NET Core documentation #36891

---

Associated WorkItem - 562514

[wadepickett]

Thanks @FelixEckl for creating this issue and showing details. We will get this fixed!

[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-18
Issue: #36892
Model: GitHub Copilot

---

Issue Analysis: Invalid moniker syntax in ASP.NET Core Options Pattern documentation

✅ Issue Validation

Status: Valid and actionable

📋 Issue Summary

The ASP.NET Core Options Pattern documentation file (options.md) contains an invalid moniker syntax on line 1399. The directive uses :::moniker-range=">= aspnetcore-8.0" (hyphenated moniker-range) instead of the correct syntax :::moniker range=">= aspnetcore-8.0" (space-separated moniker range). This causes the Microsoft Learn build system to fail to recognize the moniker directive, resulting in the raw moniker syntax being rendered on the published page rather than properly conditionally displaying content for ASP.NET Core 8.0+. All other moniker directives in the file (over 30 occurrences) correctly use the :::moniker range syntax with a space.

📁 Potentially Affected Files

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

File	Path	Lines	Section
Main article	aspnetcore/fundamentals/configuration/options.md	1399	"Validate options in a dedicated class with IValidateOptions<TOptions>"

📝 Preliminary Change Assessment

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

Potential documentation Updates

File: aspnetcore/fundamentals/configuration/options.md
Location: Line 1399 (within the "Validate options in a dedicated class with IValidateOptions<TOptions>" section)
Type: Replacement (typo fix)

Current content (line 1399):

:::moniker-range=">= aspnetcore-8.0"

Suggested direction:

:::moniker range=">= aspnetcore-8.0"

🎯 Suggested Action Plan

For documentation team review

1. Review existing PR: PR #36891

   • The issue submitter has already opened a PR that changes :::moniker-range to :::moniker range on line 1399.
   • The PR modifies exactly 1 file with 1 addition and 1 deletion — the minimal correct fix.
   • Consider reviewing and merging this PR.

2. Verify the fix on the published page:

   • After merging, confirm that the "Validate options in a dedicated class" section correctly renders the OptionsValidation2.razor example for the >= aspnetcore-8.0 moniker on the published article.

⚠️ Review Considerations

• This is a single-character fix (hyphen → space) that affects moniker-conditional rendering.
• The invalid syntax causes the OptionsValidation2.razor Blazor example in the "Validate options in a dedicated class" section to not render properly for ASP.NET Core 8.0+ readers.
• No other files appear to be affected — the issue is isolated to this one line in options.md.
• Verify no other :::moniker-range (hyphenated) typos exist elsewhere in the repository.

🔗 References

• Published article: https://learn.microsoft.com/en-us/aspnet/core/fundamentals/configuration/options?view=aspnetcore-8.0
• Related PR: #36891 - Fix moniker syntax for ASP.NET Core documentation
• Content source file: https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/fundamentals/configuration/options.md