Update deprecated ms.topic value in iis/docfx.json

[Copilot]

The globalMetadata in iis/docfx.json used the deprecated ms.topic: "conceptual" taxonomy value. No individual .md files contained the deprecated value — they already use valid values (concept-article, whats-new, faq, etc.).

Change

iis/docfx.json

// before
"ms.topic": "conceptual",

// after
"ms.topic": "concept-article",

Contributes to dotnet/AspNetCore.Docs#36930.

Original prompt

Contributes to: dotnet/AspNetCore.Docs#36930

Problem

The ms.topic global metadata value in iis/docfx.json is set to the deprecated value "conceptual". It needs to be updated to the current taxonomy value "concept-article".

What to change

In iis/docfx.json, line 52, inside globalMetadata, change:

"ms.topic": "conceptual",

to:

"ms.topic": "concept-article",

This is the only change needed. Individual .md files were searched and none contain the deprecated ms.topic: conceptual or ms.topic: article values in their front matter — they already use valid values like concept-article, whats-new, faq, landing-page, reference, etc.

No other files need to be modified.

The following is the prior conversation context from the user's chat exploration (may be truncated):

User: Contributes to: dotnet/AspNetCore.Docs#36930

ms.topic global metadata value in iis-docs/iis/docfx.json needs to be updated from the deprecated "conceptual" or "article" to the current "concept-article" taxonomy value. If any are found, update them.
Also look through all individual .md files to see if any have a meta data value of ms.topic: conceptual or ms.topic: article. Any .md with that metadata value need to change to ms.topic: concept-article

Create a PR to fix these if any are found.

If you have any questions help with acuracy let me know.

Assistant:

I'll start by investigating the current state of the ms.topic metadata in both the docfx.json configuration and the individual .md files in the iis directory.

Assistant: Now let me search more specifically for .md files with ms.topic: conceptual or ms.topic: article in their front matter:

Assistant: Here's what I found:

1. iis/docfx.json — Line 52 has "ms.topic": "conceptual" in the globalMetadata section. This needs to be updated to "concept-article".

2. Individual .md files — My code searches across the iis/ directory for .md files with ms.topic: conceptual or ms.topic: article in their front matter returned no results. The .md files I did find with ms.topic set in their front matter use valid values like concept-article, whats-new, faq, landing-page, etc. — none use the deprecated conceptual or article values.

So the only change needed is in iis/docfx.json. Let me create a PR to fix this.

Assistant: I've kicked off the process to create a PR in MicrosoftDocs/iis-docs. Here's a summary of what I found and what the PR will address:

Findings

1. iis/docfx.json (line 52) — The globalMetadata section has:

   "ms.topic": "conceptual"

   This is the deprecated value and needs to change to "concept-article".

2. Individual .md files — I searched for any .md files with ms.topic: conceptual or ms.topic: article in their front matter and found none. The existing .md files already use valid taxonomy values like concept-article, whats-new, faq, landing-page, reference, etc.

3. The fileMetadata overrides in docfx.json (lines 70–77) set ms.topic to "reference" for specific paths — this is a valid value and does not need to change.

PR Change

The PR will make a single change in iis/docfx.json:

• Before: "ms.topic": "conceptual"
• After: "ms.topic": "concept-article"

This contributes to dotnet/AspNetCore.Docs#36930. The Copilot coding agent is now working on creating the PR — you should see it appear shortly in the repository.

Note: Code search results are limited, so there's a small chance some .md files with deprecated values weren't surfaced. You can verify with a broader search in the GitHub UI to confirm completeness.

This pull request was created from Copilot chat.

---

⚡ Quickly spin up Copilot coding agent tasks from anywhere on your macOS or Windows machine with Raycast.

[wadepickett]

Approved. Also verified there are no individual .md files articles with a depreciated ms.topic value of "conceptual or "article".