Skip to content

Conversation

Copy link
Contributor

Copilot AI commented Jan 22, 2026

Updated ms.topic metadata in documentation frontmatter to align with new taxonomy standards.

Changes

  • 49 files updated: Changed ms.topic: articlems.topic: concept-article
  • 0 files found with ms.topic: conceptual (no action needed)

Affected Areas

  • YARP documentation (37 files)
  • Migration guides (9 files)
  • AOT/Request Delegate Generator (2 files)
  • Data scaffolding and metrics (1 file)

Example change in frontmatter:

---
title: Getting started with YARP
-ms.topic: article
+ms.topic: concept-article
ms.date: 3/6/2025
---
Original prompt

This section details on the original issue you should resolve

<issue_title>Update ms.topic values for article and conceptual aspnetcore.docs</issue_title>
<issue_description>For all articles in the dotnet/AspNetCore.Docs reop that contain meta data values for ms.topic in the article itself:

ms.topic: article needs to change to ms.topic: concept-article

ms.topic: conceptual needs to change to ms.topic: concept-article

It looks like there are about 71 of these.</issue_description>

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


✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.


Internal previews

Toggle expand/collapse
📄 File 🔗 Preview link
aspnetcore/data/scaffold_RP.md aspnetcore/data/scaffold_RP
aspnetcore/fundamentals/aot/request-delegate-generator/rdg-ids.md aspnetcore/fundamentals/aot/request-delegate-generator/rdg-ids
aspnetcore/fundamentals/aot/request-delegate-generator/rdg.md aspnetcore/fundamentals/aot/request-delegate-generator/rdg
aspnetcore/fundamentals/servers/yarp/ab-testing.md aspnetcore/fundamentals/servers/yarp/ab-testing
aspnetcore/fundamentals/servers/yarp/authn-authz.md aspnetcore/fundamentals/servers/yarp/authn-authz
aspnetcore/fundamentals/servers/yarp/config-files.md aspnetcore/fundamentals/servers/yarp/config-files
aspnetcore/fundamentals/servers/yarp/config-filters.md aspnetcore/fundamentals/servers/yarp/config-filters
aspnetcore/fundamentals/servers/yarp/config-providers.md aspnetcore/fundamentals/servers/yarp/config-providers
aspnetcore/fundamentals/servers/yarp/cors.md aspnetcore/fundamentals/servers/yarp/cors
aspnetcore/fundamentals/servers/yarp/destination-resolvers.md aspnetcore/fundamentals/servers/yarp/destination-resolvers
aspnetcore/fundamentals/servers/yarp/dests-health-checks.md aspnetcore/fundamentals/servers/yarp/dests-health-checks
aspnetcore/fundamentals/servers/yarp/diagnosing-yarp-issues.md aspnetcore/fundamentals/servers/yarp/diagnosing-yarp-issues
aspnetcore/fundamentals/servers/yarp/direct-forwarding.md aspnetcore/fundamentals/servers/yarp/direct-forwarding
aspnetcore/fundamentals/servers/yarp/distributed-tracing.md aspnetcore/fundamentals/servers/yarp/distributed-tracing
aspnetcore/fundamentals/servers/yarp/extensibility-transforms.md aspnetcore/fundamentals/servers/yarp/extensibility-transforms
aspnetcore/fundamentals/servers/yarp/extensibility.md aspnetcore/fundamentals/servers/yarp/extensibility
aspnetcore/fundamentals/servers/yarp/getting-started.md aspnetcore/fundamentals/servers/yarp/getting-started
aspnetcore/fundamentals/servers/yarp/grpc.md aspnetcore/fundamentals/servers/yarp/grpc
aspnetcore/fundamentals/servers/yarp/header-guidelines.md aspnetcore/fundamentals/servers/yarp/header-guidelines
aspnetcore/fundamentals/servers/yarp/header-routing.md aspnetcore/fundamentals/servers/yarp/header-routing
aspnetcore/fundamentals/servers/yarp/http-client-config.md aspnetcore/fundamentals/servers/yarp/http-client-config
aspnetcore/fundamentals/servers/yarp/http3.md aspnetcore/fundamentals/servers/yarp/http3
aspnetcore/fundamentals/servers/yarp/https-tls.md aspnetcore/fundamentals/servers/yarp/https-tls
aspnetcore/fundamentals/servers/yarp/httpsys-delegation.md aspnetcore/fundamentals/servers/yarp/httpsys-delegation
aspnetcore/fundamentals/servers/yarp/kubernetes-ingress.md aspnetcore/fundamentals/servers/yarp/kubernetes-ingress
aspnetcore/fundamentals/servers/yarp/lets-encrypt.md aspnetcore/fundamentals/servers/yarp/lets-encrypt
aspnetcore/fundamentals/servers/yarp/load-balancing.md aspnetcore/fundamentals/servers/yarp/load-balancing
aspnetcore/fundamentals/servers/yarp/middleware.md aspnetcore/fundamentals/servers/yarp/middleware
aspnetcore/fundamentals/servers/yarp/output-caching.md aspnetcore/fundamentals/servers/yarp/output-caching
aspnetcore/fundamentals/servers/yarp/queryparameter-routing.md aspnetcore/fundamentals/servers/yarp/queryparameter-routing

Note

This table shows preview links for the 30 files with the most changes. For preview links for other files in this PR, select OpenPublishing.Build Details within checks.

Co-authored-by: wadepickett <10985336+wadepickett@users.noreply.github.com>
Copilot AI changed the title [WIP] Update ms.topic values for article and conceptual in AspNetCore.Docs Update ms.topic metadata values to concept-article Jan 22, 2026
Copilot AI requested a review from wadepickett January 22, 2026 23:06
@wadepickett wadepickett marked this pull request as ready for review January 22, 2026 23:29
@wadepickett wadepickett requested a review from Copilot January 22, 2026 23:30
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates metadata taxonomy across 49 documentation files to align with Microsoft Learn standards by changing ms.topic: article to ms.topic: concept-article. The changes address the issue requirement to update both article and conceptual values, though only files with article were found and updated.

Changes:

  • Updated ms.topic metadata from article to concept-article in 49 files
  • No changes to ms.date metadata (correctly following the >50 character change threshold guideline)
  • No other content or metadata modifications

Reviewed changes

Copilot reviewed 49 out of 49 changed files in this pull request and generated no comments.

Show a summary per file
File Description
aspnetcore/migration/fx-to-core/start.md Migration documentation metadata update
aspnetcore/migration/fx-to-core/inc/systemweb-adapters.md System.Web adapters metadata update
aspnetcore/migration/fx-to-core/inc/remote-app-setup.md Remote app setup metadata update
aspnetcore/migration/fx-to-core/inc/ab-testing.md A/B testing migration metadata update
aspnetcore/migration/fx-to-core/areas/session.md Session migration metadata update
aspnetcore/migration/fx-to-core/areas/owin.md OWIN migration metadata update
aspnetcore/migration/fx-to-core/areas/machine-key.md Machine key migration metadata update
aspnetcore/migration/fx-to-core/areas/hosting.md Hosting migration metadata update
aspnetcore/migration/fx-to-core/areas/authentication.md Authentication migration metadata update
aspnetcore/log-mon/metrics/metrics.md Metrics documentation metadata update
aspnetcore/fundamentals/servers/yarp/*.md (37 files) YARP documentation metadata updates across all YARP topic files
aspnetcore/fundamentals/aot/request-delegate-generator/rdg.md Request Delegate Generator metadata update
aspnetcore/fundamentals/aot/request-delegate-generator/rdg-ids.md RDG diagnostics metadata update
aspnetcore/data/scaffold_RP.md Scaffolding documentation metadata update

@wadepickett wadepickett requested a review from tdykstra January 22, 2026 23:55
@wadepickett wadepickett merged commit 11b12a9 into main Jan 23, 2026
10 checks passed
@wadepickett wadepickett deleted the copilot/update-ms-topic-values branch January 23, 2026 00:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update ms.topic values for article and conceptual aspnetcore.docs

3 participants