Update deprecated ms.topic global metadata value to concept-article

[Copilot]

ms.topic values conceptual and article are deprecated; the replacement is concept-article. Since all content in this repo inherits ms.topic from globalMetadata in docfx.json, only one change is needed.

Verified that individual .md or .yml do not contain the depricated value.

Change

• IIS-Administration/docfx.json — globalMetadata: "ms.topic": "conceptual" → "ms.topic": "concept-article"

The fileMetadata entries scoped to "reference" are unaffected.

Original prompt

Problem

The ms.topic metadata values conceptual and article are deprecated and must be replaced with concept-article.

What needs to change

In IIS-Administration/docfx.json, the globalMetadata section currently has:

"ms.topic": "conceptual"

This must be updated to:

"ms.topic": "concept-article"

The file is located at: IIS-Administration/docfx.json (line 38 in the current version at commit c09fc47).

Additional context

• No .md or .yml files in this repository contain individual ms.topic: conceptual or ms.topic: article values in their frontmatter — they inherit from the docfx.json global metadata.
• Do NOT change the fileMetadata section's ms.topic entries that are set to "reference" — those are not deprecated.
• Only the globalMetadata "ms.topic": "conceptual" value needs to be changed to "concept-article".

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

User: Copilot Chat
Update deprecated ms.topic values in repository
You said: Update deprecated ms.topic frontmatter values across this
Update deprecated ms.topic frontmatter values across this repository

The ms.topic metadata values conceptual and article are deprecated and must be replaced with concept-article.

Scope of changes:

docfx.json (if present): If this repo contains a docfx.json file with a global-level ms.topic default set to conceptual or article, update it to concept-article.

All .md and .yml files: For every Markdown or YAML file that contains ms.topic: conceptual or ms.topic: article in its frontmatter, update the value to concept-article.

Action: Create a PR with these changes if any affected files are found.

Assistant:

Let me start by finding all affected files in the repository.

Assistant: I found that the docfx.json file contains "ms.topic": "conceptual" in globalMetadata. The markdown/YAML files don't appear to have individual ms.topic: conceptual or ms.topic: article values in their frontmatter (likely because they inherit from docfx.json's global metadata).

Let me create a PR to update the deprecated value in docfx.json.

Assistant: I'm waiting for your confirmation to proceed with creating the pull request. Please accept or reject the tool call in the dialog shown to continue.

This pull request was created from Copilot chat.

---

⌨️ Start Copilot coding agent tasks without leaving your editor — available in VS Code, Visual Studio, JetBrains IDEs and Eclipse.

[learn-build-service-prod]

Learn Build status updates of commit 6b117fa:

⚠️ Validation status: warnings

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[learn-build-service-prod]

Learn Build status updates of commit f24ee9c:

💡 Validation status: suggestions

File	Status	Preview URL	Details
IIS-Administration/docfx.json	💡Suggestion		Details

IIS-Administration/docfx.json

• Line 1, Column 1: [Suggestion: uhf-header-id-missing - See documentation] uhfHeaderId should not be null; specify the uhfHeaderId in global metadata of docfx.json file.
• Line 41, Column 27: [Suggestion: ms-author-invalid - See documentation] Invalid value for 'ms.author', 'soshir' is not a valid Microsoft alias.

For more details, please refer to the build report.

Note: Your PR may contain errors or warnings or suggestions unrelated to the files you changed. This happens when external dependencies like GitHub alias, Microsoft alias, cross repo links are updated. Please use these instructions to resolve them.

[wadepickett]

@copilot, reverify you checked all .md and .yml files for any occurances of the depricated ms.topic values. Those values at the topic level override the default global at docfx.json so they need to be addressed.

[Copilot]

@copilot, reverify you checked all .md and .yml files for any occurances of the depricated ms.topic values. Those values at the topic level override the default global at docfx.json...

Confirmed — no .md or .yml files in the repository contain ms.topic: conceptual or ms.topic: article in their frontmatter. The only occurrence was the globalMetadata entry in docfx.json, which was already updated to concept-article in commit f24ee9c.

[wadepickett]

Approved.