dotnet · BillWagner · Feb 6, 2025
@@ -249,6 +249,9 @@
                 "_csharplang/**/*.md": "language-reference",
                 "_csharpstandard/**/*.md": "language-reference",
                 "_vblang/spec/*.md": "language-reference",
+                "docs/**/includes/*.md": "include",
+                "docs/ai/how-to/**/**.md": "how-to",
+                "docs/ai/quickstarts/**/**.md": "quickstart",
                 "docs/azure/**/**.md": "conceptual",
                 "docs/core/deploying/native-aot/warnings/**.md": "error-reference",
                 "docs/core/deploying/single-file/warnings/**.md": "error-reference",
@@ -268,7 +271,7 @@
                 "docs/csharp/roslyn-sdk/tutorials/*.md": "tutorial",
                 "docs/csharp/tour-of-csharp/tutorials/**": "tutorial",
                 "docs/csharp/tutorials/**": "tutorial",
-                "docs/framework/additional-apis/**/**.md": "managed-reference",
+                "docs/framework/additional-apis/**/**.md": "reference",
                 "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",
@@ -286,10 +289,10 @@
                 "docs/framework/**/troubleshooting*.md": "troubleshooting",
                 "docs/fsharp/language-reference/**/**.md": "language-reference",
                 "docs/iot/**/*.*": "conceptual",
-                "docs/fundamentals/code-analysis/quality-rules/**.md": "reference",
-                "docs/fundamentals/code-analysis/style-rules/**.md": "reference",
+                "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/fundamentals/syslib-diagnostics/**/*.md": "reference",
                 "docs/standard/**/*how-to*.md": "how-to",
                 "docs/standard/base-types/*.md": "how-to",
                 "docs/visual-basic/language-reference/**/*.md": "language-reference",

@@ -2,7 +2,6 @@
 title: "Authenticate an Azure hosted .NET app to Azure OpenAI using Microsoft Entra ID"
 description: "Learn how to authenticate your Azure hosted .NET app to an Azure OpenAI resource using Microsoft Entra ID."
 author: haywoodsloan
-ms.topic: how-to
 ms.custom: devx-track-azurecli
 ms.date: 01/29/2025
 zone_pivot_groups: azure-interface

@@ -2,7 +2,6 @@
 title: "Authenticate and Authorize App Service to a Vector Database"
 description: "Learn how to authenticate and authorize your App Service .NET application to a vector database solution using Microsoft Entra managed identities, Key Vault, or app settings"
 author: haywoodsloan
-ms.topic: how-to
 ms.custom: devx-track-azurecli
 ms.date: 11/24/2024
 zone_pivot_groups: azure-interface

@@ -4,7 +4,6 @@ description: "Learn how to manage OpenAI content filtering programmatically in a
 ms.custom: devx-track-dotnet, devx-track-dotnet-ai
 author: alexwolfmsft
 ms.author: alexwolf
-ms.topic: how-to
 ms.date: 12/19/2024
 
 #customer intent: As a .NET developer, I want to manage OpenAI Content Filtering in a .NET app

@@ -2,7 +2,6 @@
 author: alexwolfmsft
 ms.author: alexwolf
 ms.date: 07/29/2024
-ms.topic: include
 ---
 
 AI applications often use data vector databases and services to improve relevancy and provide customized functionality. Many of these services provide a native SDK for .NET, while others offer a REST service you can connect to through custom code. Semantic Kernel provides an extensible component model that enables you to use different vector stores without needing to learn each SDK.

@@ -2,7 +2,6 @@
 title: Quickstart - Build an AI chat app with .NET
 description: Create a simple AI powered chat app using Semantic Kernel SDK for .NET and the OpenAI or Azure OpenAI SDKs
 ms.date: 07/17/2024
-ms.topic: quickstart
 ms.custom: devx-track-dotnet, devx-track-dotnet-ai
 author: fboucher
 ms.author: frbouche

@@ -2,7 +2,6 @@
 author: jmatthiesen
 ms.author: jomatthi
 ms.date: 07/03/2024
-ms.topic: include
 ---
 
 ## Clone the sample repository

@@ -2,7 +2,6 @@
 author: jmatthiesen
 ms.author: jomatthi
 ms.date: 07/03/2024
-ms.topic: include
 ---
 
 The sample GitHub repository is structured as an Azure Developer CLI (`azd`) template, which `azd` can use to provision the Azure OpenAI service and model for you.

@@ -2,7 +2,6 @@
 author: fboucher
 ms.author: frbouche
 ms.date: 05/22/2024
-ms.topic: include
 ---
 
 ## Prerequisites

@@ -2,7 +2,6 @@
 author: jmatthiesen
 ms.author: jomatthi
 ms.date: 07/03/2024
-ms.topic: include
 ---
 
 ## Prerequisites

@@ -2,7 +2,6 @@
 title: Quickstart - Build a minimal .NET AI RAG app
 description: Create an AI powered app to search and integrate with vector stores using embeddings and the Microsoft.Extensions.VectorData package for .NET
 ms.date: 12/06/2024
-ms.topic: quickstart
 ms.custom: devx-track-dotnet, devx-track-dotnet-ai
 author: fboucher
 ms.author: frbouche

@@ -2,7 +2,6 @@
 title: Quickstart - Create a minimal AI assistant using .NET
 description: Learn to create a minimal AI assistant with tooling capabilities using .NET and the Azure OpenAI SDK libraries
 ms.date: 01/25/2025
-ms.topic: quickstart
 ms.custom: devx-track-dotnet, devx-track-dotnet-ai
 author: alexwolfmsft
 ms.author: alexwolf

@@ -2,7 +2,6 @@
 title: Quickstart - Extend OpenAI using Tools and execute a local Function with .NET
 description: Create a simple chat app using OpenAI and extend the model to execute a local function.
 ms.date: 07/14/2024
-ms.topic: quickstart
 ms.custom: devx-track-dotnet, devx-track-dotnet-ai
 author: fboucher
 ms.author: frbouche

@@ -2,7 +2,6 @@
 title: Quickstart - Connect to and chat with a local AI using .NET
 description: Set up a local AI model and chat with it using a .NET console app and the Microsoft.Extensions.AI libraries
 ms.date: 12/19/2024
-ms.topic: quickstart
 ms.custom: devx-track-dotnet, devx-track-dotnet-ai
 author: alexwolfmsft
 ms.author: alexwolf

@@ -2,7 +2,6 @@
 title: Quickstart - Generate images using AI with .NET
 description: Create a simple app using to generate images using .NET and the OpenAI or Azure OpenAI models.
 ms.date: 07/17/2024
-ms.topic: quickstart
 ms.custom: devx-track-dotnet, devx-track-dotnet-ai
 author: fboucher
 ms.author: frbouche

@@ -2,7 +2,6 @@
 title: Quickstart - Summarize text using an AI chat app with .NET
 description: Create a simple chat app using Microsoft.Extensions.AI to summarize a text.
 ms.date: 07/17/2024
-ms.topic: quickstart
 ms.custom: devx-track-dotnet, devx-track-dotnet-ai
 author: fboucher
 ms.author: frbouche

@@ -2,7 +2,6 @@
 author: IEvangelist
 ms.author: dapine
 ms.date: 04/11/2022
-ms.topic: include
 ---
 
 > [!TIP]

@@ -2,7 +2,6 @@
 author: IEvangelist
 ms.author: dapine
 ms.date: 04/06/2022
-ms.topic: include
 ---
 
 > [!TIP]

@@ -2,7 +2,6 @@
 author: IEvangelist
 ms.author: dapine
 ms.date: 08/24/2022
-ms.topic: include
 ---
 
 > [!TIP]

@@ -2,7 +2,6 @@
 author: IEvangelist
 ms.author: dapine
 ms.date: 04/08/2022
-ms.topic: include
 ---
 
 > [!TIP]

@@ -2,7 +2,6 @@
 author: erjain
 ms.author: v-tjain
 ms.date: 04/13/2022
-ms.topic: include
 ---
 
 > [!TIP]

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 Locate the resource group for your app by searching for the resource group name using the search box at the top of the Azure portal. Navigate to your resource group by selecting the resource group name under the **Resource Groups** heading in the dialog box.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 On the page for the resource group, select **Access control (IAM)** from the left-hand menu.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 On the **Access control (IAM)** page:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 The **Add role assignment** page lists all of the roles that can be assigned for the resource group.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 The next **Add role assignment** page allows you to specify what user to assign the role to.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 In the **Select members** dialog:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 The Microsoft Entra group shows as selected on the **Add role assignment** screen. Select **Review + assign** to go to the final page and then **Review + assign** again to complete the process.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 Locate the resource group for your app by searching for the resource group name using the search box at the top of the Azure portal.<br>

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 On the page for the resource group, select **Access control (IAM)** from the left-hand menu.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 On the **Access control (IAM)** page:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 The **Add role assignment** page lists all of the roles that can be assigned for the resource group.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 The next **Add role assignment** page allows you to specify what user to assign the role to.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 In the **Select managed identities** dialog:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 The managed identity will now show as selected on the **Add role assignment** screen.<br>

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/02/2024
 ---
 Locate the resource group for your app by searching for the resource group name using the search box at the top of the Azure portal.<br>

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/02/2024
 ---
 On the page for the resource group, select **Access control (IAM)** from the left-hand menu.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/02/2024
 ---
 On the **Access control (IAM)** page:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/02/2024
 ---
 The **Add role assignment** page lists all of the roles that can be assigned for the resource group.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/02/2024
 ---
 The next **Add role assignment** page allows you to specify what user to assign the role to.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/02/2024
 ---
 In the **Select members** dialog:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/02/2024
 ---
 The service principal will now show as selected on the **Add role assignment** screen.<br>

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ms.custom: devx-track-azurecli
 ---

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 Navigate to the resource that hosts your application code in the Azure portal.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 On the page for your resource, select the **Identity** menu item from the left-hand menu.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 On the **Identity** page:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/15/2024
 ---
 [DefaultAzureCredential](../authentication/credential-chains.md#defaultazurecredential-overview) is an opinionated, ordered sequence of mechanisms for authenticating to Microsoft Entra ID. Each authentication mechanism is a class derived from the [TokenCredential](/dotnet/api/azure.core.tokencredential?view=azure-dotnet&preserve-view=true) class and is known as a *credential*. At runtime, `DefaultAzureCredential` attempts to authenticate using the first credential. If that credential fails to acquire an access token, the next credential in the sequence is attempted, and so on, until an access token is successfully obtained. In this way, your app can use different credentials in different environments without writing environment-specific code.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 Navigate to the Microsoft Entra ID page in the Azure portal by typing *Microsoft Entra ID* into the search box at the top of the page. Select **Microsoft Entra ID** under the **Services** section.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 On the **Microsoft Entra ID** page, select **Groups** from the left-hand menu.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 On the **All groups** page, select **New group**.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 On the **New Group** page:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 On the **Add members** dialog box:

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 07/31/2024
 ---
 Back on the **New group** page, select **Create** to create the group.

@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 Navigate to the Microsoft Entra ID page in the Azure portal by typing *Microsoft Entra ID* into the search box at the top of the page. Select **Microsoft Entra ID** under the **Services** section.
@@ -1,5 +1,4 @@
 ---
-ms.topic: include
 ms.date: 08/05/2024
 ---
 On the **Microsoft Entra ID** page, select **Groups** from the left-hand menu.