Skip to content

Updating ms.topic for AI readiness #46448

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 5 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 25 additions & 5 deletions docfx.json
Original file line number Diff line number Diff line change
Expand Up @@ -153,7 +153,7 @@
"ms.author": "dotnetcontent",
"ms.devlang": "dotnet",
"ms.service": "dotnet",
"ms.topic": "conceptual",
"ms.topic": "article",
"searchScope": [
".NET"
],
Expand Down Expand Up @@ -255,7 +255,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",
Expand All @@ -264,22 +266,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/**": "concept-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",
Expand All @@ -292,16 +300,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",
Expand Down
2 changes: 1 addition & 1 deletion docs/ai/azure-ai-services-authentication.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand Down
2 changes: 1 addition & 1 deletion docs/azure/azure-tools.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/configure-visual-studio.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/configure-vs-code.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/create-azure-account.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/dotnet-dev-env-checklist.md
Original file line number Diff line number Diff line change
@@ -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
---
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/install-azure-cli.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/key-azure-services.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
---

Expand Down
2 changes: 1 addition & 1 deletion docs/azure/migration/app-service.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/migration/appcat/custom-configuration.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/migration/appcat/dotnet-cli.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/migration/appcat/faq.md
Original file line number Diff line number Diff line change
@@ -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
---

Expand Down
2 changes: 1 addition & 1 deletion docs/azure/migration/appcat/install.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/migration/appcat/interpret-results.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/migration/appcat/visual-studio-copilot.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/migration/appcat/visual-studio.md
Original file line number Diff line number Diff line change
@@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/sdk/aspnetcore-guidance.md
Original file line number Diff line number Diff line change
@@ -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
---
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/sdk/authentication/best-practices.md
Original file line number Diff line number Diff line change
@@ -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
---

Expand Down
2 changes: 1 addition & 1 deletion docs/azure/sdk/authentication/credential-chains.md
Original file line number Diff line number Diff line change
@@ -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: 02/13/2025
---

Expand Down
2 changes: 1 addition & 1 deletion docs/azure/sdk/authentication/index.md
Original file line number Diff line number Diff line change
@@ -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
---
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/sdk/azure-sdk-for-dotnet.md
Original file line number Diff line number Diff line change
@@ -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
---
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/sdk/configure-proxy.md
Original file line number Diff line number Diff line change
@@ -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
---
Expand Down
2 changes: 1 addition & 1 deletion docs/azure/sdk/protocol-convenience-methods.md
Original file line number Diff line number Diff line change
@@ -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
---
Expand Down
2 changes: 1 addition & 1 deletion docs/core/compatibility/api-removal.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: concept-article
---
# API removal in .NET

Expand Down
2 changes: 1 addition & 1 deletion docs/core/compatibility/breaking-changes.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: concept-article
---
# Breaking changes in .NET

Expand Down
2 changes: 1 addition & 1 deletion docs/core/compatibility/categories.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: concept-article
---
# How code changes can affect compatibility

Expand Down
2 changes: 1 addition & 1 deletion docs/core/compatibility/library-change-rules.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: concept-article
---
# Change rules for compatibility

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/core/diagnostics/observability-otlp-example.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: concept-article
---

# Example: Use OpenTelemetry with OTLP and the standalone Aspire Dashboard
Expand Down
2 changes: 1 addition & 1 deletion docs/core/diagnostics/observability-prgrja-example.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: concept-article
---

# Example: Use OpenTelemetry with Prometheus, Grafana, and Jaeger
Expand Down
2 changes: 1 addition & 1 deletion docs/core/diagnostics/observability-with-otel.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: concept-article
---

# .NET observability with OpenTelemetry
Expand Down
2 changes: 1 addition & 1 deletion docs/core/extensions/dependency-injection-guidelines.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/core/project-sdk/overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 1 addition & 1 deletion docs/core/resources/manifest-file-names.md
Original file line number Diff line number Diff line change
Expand Up @@ -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: concept-article
---
# How resource manifest files are named

Expand Down
Loading