Updating ms.topic for AI readiness (#46448)

* updating ms.topic for AI readiness

* adding Genevieve's comments

* Update docfx.json

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/compatibility/api-removal.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/compatibility/breaking-changes.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/compatibility/categories.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/parsing-strings.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/substitutions-in-regular-expressions.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/the-regular-expression-object-model.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/type-conversion.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/compatibility/library-change-rules.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/diagnostics/observability-otlp-example.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/diagnostics/observability-prgrja-example.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/diagnostics/observability-with-otel.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/resources/manifest-file-names.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/core/runtime-config/index.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/csharp/how-to/index.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/framework/additional-apis/index.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/machine-learning/resources/ml-net-cli-telemetry.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/basic-string-operations.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/best-practices-display-data.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/character-escapes-in-regular-expressions.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/comparing.md

Co-authored-by: Bill Wagner <[email protected]>

* Update docs/standard/base-types/details-of-regular-expression-behavior.md

Co-authored-by: Bill Wagner <[email protected]>

---------

Co-authored-by: Bill Wagner <[email protected]>

Author: nathlaroche

docfx.json

@@ -157,7 +157,7 @@
             "ms.author": "dotnetcontent",
             "ms.devlang": "dotnet",
             "ms.service": "dotnet",
-            "ms.topic": "conceptual",
+            "ms.topic": "article",
             "searchScope": [
                 ".NET"
             ],
@@ -259,7 +259,9 @@
                 "_csharplang/**/*.md": "language-reference",
                 "_csharpstandard/**/*.md": "language-reference",
                 "_vblang/spec/*.md": "language-reference",
-                "docs/azure/**/**.md": "conceptual",
+                "docs/architecture/**/*.md": "concept-article",
+                "docs/azure/migration/**/*.md": "upgrade-and-migration-article",
+                "docs/core/compatibility/**/*.md": "concept-article",
                 "docs/core/deploying/native-aot/warnings/**.md": "error-reference",
                 "docs/core/deploying/single-file/warnings/**.md": "error-reference",
                 "docs/core/deploying/trimming/trim-warnings/**.md": "error-reference",
@@ -268,22 +270,28 @@
                 "docs/core/tools/sdk-errors/*.md": "error-reference",
                 "docs/core/testing/mstest-analyzers/*.md": "error-reference",
                 "docs/core/tutorials/**.md": "tutorial",
+                "docs/core/unmanaged-api/**/*.md": "reference",
+                "docs/core/whats-new/**/*.md": "whats-new",
+                "docs/csharp/advanced-topics/interface-implementation/**.md": "tutorial",
                 "docs/csharp/getting-started/**/*.md": "overview",
                 "docs/csharp/how-to/**/*.md": "how-to",
                 "docs/csharp/language-reference/**/*.md": "language-reference",
                 "docs/csharp/language-reference/compiler-messages/*.md": "error-reference",
                 "docs/csharp/linq/*.md": "how-to",
                 "docs/csharp/misc/*.md": "error-reference",
-                "docs/csharp/programming-guide/**": "conceptual",
+                "docs/csharp/programming-guide/**": "article",
                 "docs/csharp/roslyn-sdk/get-started/*.md": "tutorial",
                 "docs/csharp/roslyn-sdk/tutorials/*.md": "tutorial",
+                "docs/csharp/tour-of-csharp/*.md": "overview",
                 "docs/csharp/tour-of-csharp/tutorials/**": "tutorial",
                 "docs/csharp/tutorials/**": "tutorial",
                 "docs/framework/additional-apis/**/**.md": "reference",
+                "docs/framework/app-domains/**/*.md": "concept-article",
                 "docs/framework/configure-apps/file-schema/**/**.md": "reference",
                 "docs/framework/data/adonet/ef/language-reference/*-entity-sql.md": "language-reference",
                 "docs/framework/debug-trace-profile/*-mda.md": "reference",
                 "docs/framework/performance/*-etw-events.md": "reference",
+                "docs/framework/release-notes/**.md": "release-notes",
                 "docs/framework/tools/**/**.md": "reference",
                 "docs/framework/unmanaged-api/**/**.md": "reference",
                 "docs/framework/wcf/diagnostics/etw/**.md": "reference",
@@ -296,16 +304,28 @@
                 "docs/framework/**/how-to*.md": "how-to",
                 "docs/framework/**/troubleshooting*.md": "troubleshooting",
                 "docs/fsharp/language-reference/**/**.md": "language-reference",
-                "docs/iot/**/*.*": "conceptual",
+                "docs/fsharp/tutorials/*.md": "tutorial",
+                "docs/fsharp/get-started/**/*.md": "get-started",
+                "docs/fundamentals/**/how-to*.md": "how-to",
+                "docs/fundamentals/apicompat/package-validation/**.md": "how-to",
                 "docs/fundamentals/code-analysis/quality-rules/**.md": "error-reference",
                 "docs/fundamentals/code-analysis/style-rules/**.md": "error-reference",
                 "docs/fundamentals/diagnostics/runtime-*.md": "reference",
                 "docs/fundamentals/syslib-diagnostics/**/*.md": "error-reference",
-                "docs/standard/**/*how-to*.md": "how-to",
+                "docs/orleans/tutorials-and-samples/**.md": "tutorial",
+                "docs/samples-and-tutorials/*.md": "tutorial",
+                "docs/standard/**/how-to*.md": "how-to",
                 "docs/standard/base-types/*.md": "how-to",
+                "docs/standard/design-guidelines": "concept-article",
+                "docs/standard/serialization/binaryformatter-migration-guide/**.md": "upgrade-and-migration-article",
+                "docs/visual-basic/developing-apps/**/*.md": "how-to",
                 "docs/visual-basic/language-reference/**/*.md": "language-reference",
                 "docs/visual-basic/reference/**/*.md": "language-reference",
                 "docs/visual-basic/misc/bc*.md": "error-reference",
+                "docs/visual-basic/programming-guide/**/how-to*.md": "how-to",
+                "docs/visual-basic/programming-guide/**/troubleshooting*.md": "troubleshooting",
+                "docs/visual-basic/programming-guide/concepts/**/*.md": "concept-article",
+                "docs/visual-basic/programming-guide/language-features/constants-enums/*.md": "concept-article",
                 "docs/visual-basic/**/troubleshooting*.md": "troubleshooting",
                 "docs/windows-workflow-foundation/1*.md": "error-reference",
                 "docs/windows-workflow-foundation/2*.md": "error-reference",

docs/ai/azure-ai-services-authentication.md

@@ -2,7 +2,7 @@
 title: Authenticate to Azure OpenAI using .NET
 description: Learn about the different options to authenticate to Azure OpenAI and other services using .NET
 author: alexwolfmsft
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 04/09/2025
 ---
 

docs/azure/azure-tools.md

@@ -1,7 +1,7 @@
 ---
 title: Additional Azure Tools
 description: This article describes additional tools and utilities for working with Azure and how you can install them.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23, devx-track-azurepowershell
 ms.date: 8/15/2024
 author: alexwolfmsft

docs/azure/configure-visual-studio.md

@@ -1,7 +1,7 @@
 ---
 title: Configure Visual Studio for Azure Development with .NET
 description: This article helps you configure Visual Studio for Azure development including getting the right workloads installed and connecting Visual Studio to your Azure account.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23
 ms.date: 3/20/2025
 author: alexwolfmsft

docs/azure/configure-vs-code.md

@@ -1,7 +1,7 @@
 ---
 title: Configure Visual Studio Code for Azure development with .NET
 description: This article helps you configure Visual Studio Code for Azure development including getting the right plugins installed and configured in VS Code
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, vscode-azure-extension-update-completed, engagement-fy23
 ms.date: 8/15/2024
 author: alexwolfmsft

docs/azure/create-azure-account.md

@@ -1,7 +1,7 @@
 ---
 title: Create an Azure account
 description: To use Azure, you need an Azure account.  This article covers the three most common ways to sign up for an Azure account.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23
 ms.date: 8/15/2024
 author: alexwolfmsft

docs/azure/dotnet-dev-env-checklist.md

@@ -1,7 +1,7 @@
 ---
 title: .NET Development on Azure Configuration Checklist
 description: Provides a quick summary of all the tools you should have installed to do .NET development with Azure
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23, devx-track-azurecli
 ms.date: 8/15/2024
 ---

docs/azure/install-azure-cli.md

@@ -1,7 +1,7 @@
 ---
 title: Installing the Azure CLI
 description: Azure developers will need the Azure CLI installed, so this article describes why you need the CLI and where to download and install it from.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23, devx-track-azurecli
 ms.date: 8/15/2024
 author: alexwolfmsft

docs/azure/key-azure-services.md

@@ -2,7 +2,7 @@
 title: Key Azure Services for .NET developers
 description: Azure has over 100 services, but this article focuses on the ~8 or so services used by .NET developers most frequently
 ms.date: 08/15/2024
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23
 ---
 

docs/azure/migration/app-service.md

@@ -1,7 +1,7 @@
 ---
 title: Migrate your .NET web app or service to Azure App Service
 description: Learn about migrating a .NET web app or service from on-premises to Azure App Service.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 07/08/2020
 ---
 # Migrate your .NET web app or service to Azure App Service