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 <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

* Update docs/core/compatibility/categories.md

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

---------

Co-authored-by: Bill Wagner <wiwagn@microsoft.com>

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

docs/azure/migration/appcat/app-code-assessment-toolkit.md

@@ -1,7 +1,7 @@
 ---
 title: Azure Migrate application and code assessment for .NET
 description: Learn how to assess .NET applications to evaluate their readiness to migrate to Azure.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 11/09/2023
 author: codemillmatt
 ms.author: masoucou

docs/azure/migration/appcat/custom-configuration.md

@@ -1,7 +1,7 @@
 ---
 title: How to customize analysis with JSON run configurations
 description: Learn how to include a JSON file to configure your code assessment
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 08/02/2024
 author: mckennabarlow
 ms.author: mcbarlow

docs/azure/migration/appcat/dotnet-cli.md

@@ -1,7 +1,7 @@
 ---
 title: Use Azure Migrate application and code assessment for .NET with the .NET CLI
 description: Learn how to assess .NET applications to evaluate their readiness to migrate to Azure with the .NET CLI.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 11/10/2023
 author: codemillmatt
 ms.author: masoucou

docs/azure/migration/appcat/faq.md

@@ -1,7 +1,7 @@
 ---
 title: Azure Migrate application and code assessment for .NET FAQ
 description: Frequently asked questions for the Azure Migrate application and code assessment for .NET
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 08/16/2024
 ---
 

docs/azure/migration/appcat/install.md

@@ -1,7 +1,7 @@
 ---
 title: Azure Migrate application and code assessment for .NET installation
 description: Learn how to install Azure Migrate application and code assessment for .NET
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 11/09/2023
 author: codemillmatt
 ms.author: masoucou

docs/azure/migration/appcat/interpret-results.md

@@ -1,7 +1,7 @@
 ---
 title: Interpret the analysis results from the Azure Migrate application and code assessment for .NET
 description: Learn how to interpret the results the analysis of .NET applications with the Azure Migrate application and code assessment tool.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 11/13/2023
 author: codemillmatt
 ms.author: masoucou

docs/azure/migration/appcat/visual-studio-copilot.md

@@ -1,7 +1,7 @@
 ---
 title: Use GitHub Copilot for Visual Studio with the Azure Migrate application and code assessment for .NET
 description: Learn how to use GitHub Copilot with the Azure Migrate application and code assessment tool for .NET when evaluating apps for Azure migrations.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 10/09/2024
 author: alexwolfmsft
 ms.author: alexwolf

docs/azure/migration/appcat/visual-studio.md

@@ -1,7 +1,7 @@
 ---
 title: Use Azure Migrate application and code assessment for .NET with Visual Studio
 description: Learn how to assess .NET applications to evaluate their readiness to migrate to Azure with Visual Studio.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 11/09/2023
 author: codemillmatt
 ms.author: masoucou

docs/azure/sdk/aspnetcore-guidance.md

@@ -1,7 +1,7 @@
 ---
 title: Best practices for using the Azure SDK with ASP.NET Core
 description: Learn best practices and the steps to properly implement the Azure SDK for .NET in your ASP.NET Core apps.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet
 ms.date: 10/22/2024
 ---

docs/azure/sdk/authentication/best-practices.md

@@ -1,7 +1,7 @@
 ---
 title: Authentication best practices with the Azure Identity library for .NET
 description: This article describes authentication best practices to follow when using the Azure Identity library for .NET.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 02/14/2025
 ---
 

docs/azure/sdk/authentication/credential-chains.md

@@ -1,7 +1,7 @@
 ---
 title: 'Credential chains in the Azure Identity library for .NET'
 description: 'This article describes the DefaultAzureCredential and ChainedTokenCredential classes in the Azure Identity library.'
-ms.topic: conceptual
+ms.topic: concept-article
 ms.date: 05/30/2025
 ---
 

docs/azure/sdk/authentication/index.md

@@ -1,7 +1,7 @@
 ---
 title: How to authenticate .NET applications with Azure services
 description: Learn how to authenticate a .NET app with Azure services by using classes in the Azure Identity library.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23
 ms.date: 08/02/2024
 ---

docs/azure/sdk/azure-sdk-for-dotnet.md

@@ -1,7 +1,7 @@
 ---
 title: Azure SDK for .NET Overview
 description: Provides an overview of what the Azure SDK for .NET is and the basic steps to use the SDK in a .NET application
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23
 ms.date: 04/25/2025
 ---

docs/azure/sdk/configure-proxy.md

@@ -1,7 +1,7 @@
 ---
 title: Configure a proxy when using the Azure SDK for .NET 
 description: Learn different approaches for configuring a proxy for use with the Azure SDK for .NET client libraries.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23
 ms.date: 04/25/2025
 ---

docs/azure/sdk/protocol-convenience-methods.md

@@ -1,7 +1,7 @@
 ---
 title: Understand Azure SDK client library method types
 description: Learn about the key differences between protocol and convenience methods in the Azure SDK client libraries for .NET.
-ms.topic: conceptual
+ms.topic: concept-article
 ms.custom: devx-track-dotnet, engagement-fy23, devx-track-arm-template
 ms.date: 04/25/2025
 ---

docs/core/compatibility/api-removal.md

@@ -3,7 +3,7 @@ title: API removal in .NET
 titleSuffix: ""
 description: Learn about .NET's policy for obsoleting and removing APIs.
 ms.date: 04/27/2023
-ms.topic: conceptual
+ms.topic: article
 ---
 # API removal in .NET
 

docs/core/compatibility/breaking-changes.md

@@ -2,7 +2,7 @@
 title: .NET breaking changes reference
 description: Learn how to navigate the .NET breaking changes reference.
 ms.date: 12/22/2022
-ms.topic: conceptual
+ms.topic: article
 ---
 # Breaking changes in .NET
 

docs/core/compatibility/categories.md

@@ -2,7 +2,7 @@
 title: Compatibility
 description: Learn about the ways in which code changes can affect compatibility in .NET.
 ms.date: 06/10/2019
-ms.topic: conceptual
+ms.topic: article
 ---
 # How code changes can affect compatibility
 

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

@@ -2,7 +2,7 @@
 title: .NET API changes that affect compatibility
 description: Learn how .NET attempts to maintain compatibility for developers across .NET versions, and what kind of change is considered a breaking change.
 ms.date: 05/12/2021
-ms.topic: conceptual
+ms.topic: article
 ---
 # Change rules for compatibility
 

docs/core/diagnostics/observability-applicationinsights.md

@@ -2,7 +2,7 @@
 title: "Example: Use OpenTelemetry with Azure Monitor and Application Insights"
 description: An walkthrough of how to use OpenTelemetry in .NET to export telemetry to Application Insights
 ms.date: 8/21/2024
-ms.topic: conceptual
+ms.topic: concept-article
 ---
 
 # Example: Use OpenTelemetry with Azure Monitor and Application Insights

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

@@ -2,7 +2,7 @@
 title: "Example: Use OpenTelemetry with OTLP and the standalone Aspire Dashboard"
 description: An introduction to observing .NET apps with OTLP and the standalone Aspire Dashboard
 ms.date: 6/14/2023
-ms.topic: conceptual
+ms.topic: article
 ---
 
 # Example: Use OpenTelemetry with OTLP and the standalone Aspire Dashboard

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

@@ -2,7 +2,7 @@
 title: "Example: Use OpenTelemetry with Prometheus, Grafana, and Jaeger"
 description: An walkthrough of how to use OpenTelemetry in .NET to export telemetry to Prometheus, Grafana, and Jaeger
 ms.date: 6/14/2023
-ms.topic: conceptual
+ms.topic: article
 ---
 
 # Example: Use OpenTelemetry with Prometheus, Grafana, and Jaeger

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

@@ -2,7 +2,7 @@
 title: .NET Observability with OpenTelemetry
 description: An introduction to observing .NET apps with OpenTelemetry
 ms.date: 6/14/2023
-ms.topic: conceptual
+ms.topic: article
 ---
 
 # .NET observability with OpenTelemetry

docs/core/extensions/dependency-injection-guidelines.md

@@ -4,7 +4,7 @@ description: Discover effective dependency injection guidelines and best practic
 author: IEvangelist
 ms.author: dapine
 ms.date: 07/18/2024
-ms.topic: conceptual
+ms.topic: concept-article
 ---
 
 # Dependency injection guidelines

docs/core/project-sdk/overview.md

@@ -3,7 +3,7 @@ title: .NET project SDK overview
 titleSuffix: ""
 description: Learn about the .NET project SDKs.
 ms.date: 10/15/2024
-ms.topic: conceptual
+ms.topic: concept-article
 no-loc: ["EmbeddedResource", "Compile", "None", "Blazor"]
 ---
 # .NET project SDKs

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

@@ -2,7 +2,7 @@
 title: How MSBuild generates manifest file names
 description: Describes the factors that influence the name of a resource manifest file name that's generated by MSBuild at compile time.
 ms.date: 05/08/2020
-ms.topic: conceptual
+ms.topic: article
 ---
 # How resource manifest files are named