Replace "marker service" with "marker interface" in IAuthorizationRequirement documentation

[Copilot]

Fixes #36772

Corrects terminology for IAuthorizationRequirement from "marker service" to "marker interface" in authorization policies documentation.

Changes

• aspnetcore/security/authorization/policies.md: Updated line 32 to use correct terminology
• aspnetcore/security/authorization/policies/includes/policies5.md: Updated line 19 to use correct terminology
• Updated metadata: Added ai-usage and refreshed ms.date

Context

IAuthorizationRequirement is an interface with no methods, used for type identification. Both documents already used "marker interface" correctly in later sections, creating an inconsistency that this PR resolves.

Before:

IAuthorizationRequirement is a marker service with no methods...

After:

IAuthorizationRequirement is a marker interface with no methods...

Original prompt

---

This section details on the original issue you should resolve

<issue_title>Replace "marker service" with "marker interface" in the definition of IAuthorizationRequirement</issue_title>
<issue_description>### Description

In the following statement (emphasis mine) the term marker service should be replaced with marker interface for the sake of technical accuracy and to avoid confusion.

IAuthorizationRequirement is a marker service with no methods, and the mechanism for tracking whether authorization is successful.

Incidentally further below in the same article the same IAuthorizationRequirement interface is already correctly defined as a marker interface.

A requirement implements IAuthorizationRequirement, which is an empty marker interface.

Page URL

https://learn.microsoft.com/en-us/aspnet/core/security/authorization/policies?view=aspnetcore-8.0&WT.mc_id=DT-MVP-5004452

Content source URL

https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/security/authorization/policies.md

Document ID

7089b376-949f-c1c6-c37a-5d8cc7ecf104

Platform Id

2ff2ae4f-f6b8-67e8-2d6f-147b165b6706

Article author

@wadepickett

Metadata

• ID: b1141d92-adeb-6841-229f-914c808f9a2b
• PlatformId: 2ff2ae4f-f6b8-67e8-2d6f-147b165b6706
• Service: aspnet-core
• Sub-service: security

Related Issues</issue_description>

<agent_instructions>In additon to reading the description, read all comments in the discussion and give special attention to the triage report suggestions in the discussion.</agent_instructions>

Comments on the Issue (you are @copilot in this section)

@wadepickett @eugenehavryliuk, thanks very much for taking the time to point out this issue. Much appreciated! @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-02-17
Issue: 36772
Model: GitHub Copilot

---

Issue Analysis: Replace "marker service" with "marker interface" in IAuthorizationRequirement description

✅ Issue Validation

Status: Valid and actionable

📋 Issue Summary

The documentation for ASP.NET Core policy-based authorization incorrectly refers to IAuthorizationRequirement as a "marker service" when the technically accurate term is "marker interface." This is an interface (not a service), and the well-established .NET term for an empty interface used for type identification is "marker interface." The same article already correctly uses "marker interface" in a later section, creating an internal inconsistency. This terminology error appears in two files: the main article (policies.md) and the older-version include file (policies5.md).

📁 Potentially Affected Files

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

File	Path	Lines	Section
Main article (≥ 6.0)	aspnetcore/security/authorization/policies.md	31	"IAuthorizationService"
Include file (< 6.0)	aspnetcore/security/authorization/policies/includes/policies5.md	19	"IAuthorizationService"

📝 Preliminary Change Assessment

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

Potential Documentation Update #1

File: aspnetcore/security/authorization/policies.md
Location: Line 31 (within the "IAuthorizationService" section)
Type: Replacement (single word)

Current content (line 31):

<xref:Microsoft.AspNetCore.Authorization.IAuthorizationRequirement> is a marker service with no methods, and the mechanism for tracking whether authorization is s...

</details>



<!-- START COPILOT CODING AGENT SUFFIX -->

- Fixes dotnet/AspNetCore.Docs#36772

<!-- START COPILOT CODING AGENT TIPS -->
---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more [Copilot coding agent tips](https://gh.io/copilot-coding-agent-tips) in the docs.

<!-- PREVIEW-TABLE-START -->

---

#### Internal previews

| 📄 File | 🔗 Preview link |
|:--|:--|
| [aspnetcore/security/authorization/policies.md](https://github.com/dotnet/AspNetCore.Docs/blob/bced63722158eb8bafaa567a65971dd5c2050d6d/aspnetcore/security/authorization/policies.md) | [aspnetcore/security/authorization/policies](https://review.learn.microsoft.com/en-us/aspnet/core/security/authorization/policies?branch=pr-en-us-36775) |

<!-- PREVIEW-TABLE-END -->

[wadepickett]

Approved.