diff --git a/docfx.json b/docfx.json index 19b2441f2fb2b..e2915c9d00dc8 100644 --- a/docfx.json +++ b/docfx.json @@ -153,7 +153,7 @@ "ms.author": "dotnetcontent", "ms.devlang": "dotnet", "ms.service": "dotnet", - "ms.topic": "conceptual", + "ms.topic": "article", "searchScope": [ ".NET" ], @@ -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", @@ -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", @@ -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", diff --git a/docs/ai/azure-ai-services-authentication.md b/docs/ai/azure-ai-services-authentication.md index 1fc6b79f281d6..bbb0e6debda8c 100644 --- a/docs/ai/azure-ai-services-authentication.md +++ b/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 --- diff --git a/docs/azure/azure-tools.md b/docs/azure/azure-tools.md index e2f235aad9b0b..b8dd99793553d 100644 --- a/docs/azure/azure-tools.md +++ b/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 diff --git a/docs/azure/configure-visual-studio.md b/docs/azure/configure-visual-studio.md index ce6360f015886..2d262f91b622b 100644 --- a/docs/azure/configure-visual-studio.md +++ b/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 diff --git a/docs/azure/configure-vs-code.md b/docs/azure/configure-vs-code.md index 93276a90c8f45..a3dc18f4bf3c2 100644 --- a/docs/azure/configure-vs-code.md +++ b/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 diff --git a/docs/azure/create-azure-account.md b/docs/azure/create-azure-account.md index 21f053fcc622c..0e8d84480d573 100644 --- a/docs/azure/create-azure-account.md +++ b/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 diff --git a/docs/azure/dotnet-dev-env-checklist.md b/docs/azure/dotnet-dev-env-checklist.md index c6c6bb2bcc762..bfb1940bf58fa 100644 --- a/docs/azure/dotnet-dev-env-checklist.md +++ b/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 --- diff --git a/docs/azure/install-azure-cli.md b/docs/azure/install-azure-cli.md index 1a73f0850645b..62ca138e962e2 100644 --- a/docs/azure/install-azure-cli.md +++ b/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 diff --git a/docs/azure/key-azure-services.md b/docs/azure/key-azure-services.md index 347c630743840..2fda49e09bb58 100644 --- a/docs/azure/key-azure-services.md +++ b/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 --- diff --git a/docs/azure/migration/app-service.md b/docs/azure/migration/app-service.md index da428f95a95a7..6a6a119d2ba72 100644 --- a/docs/azure/migration/app-service.md +++ b/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 diff --git a/docs/azure/migration/appcat/app-code-assessment-toolkit.md b/docs/azure/migration/appcat/app-code-assessment-toolkit.md index e0dd082cb604e..c619c240502f1 100644 --- a/docs/azure/migration/appcat/app-code-assessment-toolkit.md +++ b/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 diff --git a/docs/azure/migration/appcat/custom-configuration.md b/docs/azure/migration/appcat/custom-configuration.md index f7d6ca080fa88..e130082b66697 100644 --- a/docs/azure/migration/appcat/custom-configuration.md +++ b/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 diff --git a/docs/azure/migration/appcat/dotnet-cli.md b/docs/azure/migration/appcat/dotnet-cli.md index 18891962a78a7..30d5f01f5f46c 100644 --- a/docs/azure/migration/appcat/dotnet-cli.md +++ b/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 diff --git a/docs/azure/migration/appcat/faq.md b/docs/azure/migration/appcat/faq.md index 992aede27458c..3c94eeef6bd54 100644 --- a/docs/azure/migration/appcat/faq.md +++ b/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 --- diff --git a/docs/azure/migration/appcat/install.md b/docs/azure/migration/appcat/install.md index 3fbae32ad4b66..8bffbb04f76d2 100644 --- a/docs/azure/migration/appcat/install.md +++ b/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 diff --git a/docs/azure/migration/appcat/interpret-results.md b/docs/azure/migration/appcat/interpret-results.md index 53a727df94faf..6f34c2d8255d9 100644 --- a/docs/azure/migration/appcat/interpret-results.md +++ b/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 diff --git a/docs/azure/migration/appcat/visual-studio-copilot.md b/docs/azure/migration/appcat/visual-studio-copilot.md index 882842eb0db64..27c3713750b2b 100644 --- a/docs/azure/migration/appcat/visual-studio-copilot.md +++ b/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 diff --git a/docs/azure/migration/appcat/visual-studio.md b/docs/azure/migration/appcat/visual-studio.md index 9a7b8366962fb..d3ecd63855435 100644 --- a/docs/azure/migration/appcat/visual-studio.md +++ b/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 diff --git a/docs/azure/sdk/aspnetcore-guidance.md b/docs/azure/sdk/aspnetcore-guidance.md index 0f0169fd0f8b4..d5b619789e14b 100644 --- a/docs/azure/sdk/aspnetcore-guidance.md +++ b/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 --- diff --git a/docs/azure/sdk/authentication/best-practices.md b/docs/azure/sdk/authentication/best-practices.md index bca7605686bcd..19c68f1d7346d 100644 --- a/docs/azure/sdk/authentication/best-practices.md +++ b/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 --- diff --git a/docs/azure/sdk/authentication/credential-chains.md b/docs/azure/sdk/authentication/credential-chains.md index 1b8d82c1bee79..675acdd70b439 100644 --- a/docs/azure/sdk/authentication/credential-chains.md +++ b/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: 02/13/2025 --- diff --git a/docs/azure/sdk/authentication/index.md b/docs/azure/sdk/authentication/index.md index 5707fb44788ed..fa2e5ad70ab31 100644 --- a/docs/azure/sdk/authentication/index.md +++ b/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 --- diff --git a/docs/azure/sdk/azure-sdk-for-dotnet.md b/docs/azure/sdk/azure-sdk-for-dotnet.md index 5fd273bf246be..0abe1059e1c32 100644 --- a/docs/azure/sdk/azure-sdk-for-dotnet.md +++ b/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 --- diff --git a/docs/azure/sdk/configure-proxy.md b/docs/azure/sdk/configure-proxy.md index 2ca9b0280c69c..5d857c56c62c9 100644 --- a/docs/azure/sdk/configure-proxy.md +++ b/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 --- diff --git a/docs/azure/sdk/protocol-convenience-methods.md b/docs/azure/sdk/protocol-convenience-methods.md index 69481c779e50c..e2974c8333b4a 100644 --- a/docs/azure/sdk/protocol-convenience-methods.md +++ b/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 --- diff --git a/docs/core/compatibility/api-removal.md b/docs/core/compatibility/api-removal.md index 7686ec3cde85c..15bfdd52765fc 100644 --- a/docs/core/compatibility/api-removal.md +++ b/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: concept-article --- # API removal in .NET diff --git a/docs/core/compatibility/breaking-changes.md b/docs/core/compatibility/breaking-changes.md index 91c36798c1cf0..e561757d379dc 100644 --- a/docs/core/compatibility/breaking-changes.md +++ b/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: concept-article --- # Breaking changes in .NET diff --git a/docs/core/compatibility/categories.md b/docs/core/compatibility/categories.md index 4c7e8d33ee587..b664805af4324 100644 --- a/docs/core/compatibility/categories.md +++ b/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: concept-article --- # How code changes can affect compatibility diff --git a/docs/core/compatibility/library-change-rules.md b/docs/core/compatibility/library-change-rules.md index 748a4d07930b0..849caec762031 100644 --- a/docs/core/compatibility/library-change-rules.md +++ b/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: concept-article --- # Change rules for compatibility diff --git a/docs/core/diagnostics/observability-applicationinsights.md b/docs/core/diagnostics/observability-applicationinsights.md index ccbeda438191c..c7c797a22e613 100644 --- a/docs/core/diagnostics/observability-applicationinsights.md +++ b/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 diff --git a/docs/core/diagnostics/observability-otlp-example.md b/docs/core/diagnostics/observability-otlp-example.md index 3989d87589063..d2d1cddd44a63 100644 --- a/docs/core/diagnostics/observability-otlp-example.md +++ b/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: concept-article --- # Example: Use OpenTelemetry with OTLP and the standalone Aspire Dashboard diff --git a/docs/core/diagnostics/observability-prgrja-example.md b/docs/core/diagnostics/observability-prgrja-example.md index c7b8316894968..8e4c50d04175f 100644 --- a/docs/core/diagnostics/observability-prgrja-example.md +++ b/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: concept-article --- # Example: Use OpenTelemetry with Prometheus, Grafana, and Jaeger diff --git a/docs/core/diagnostics/observability-with-otel.md b/docs/core/diagnostics/observability-with-otel.md index 8e7d2572b16bc..b667196533412 100644 --- a/docs/core/diagnostics/observability-with-otel.md +++ b/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: concept-article --- # .NET observability with OpenTelemetry diff --git a/docs/core/extensions/dependency-injection-guidelines.md b/docs/core/extensions/dependency-injection-guidelines.md index aea1236f9cc8c..29ab417a6de92 100644 --- a/docs/core/extensions/dependency-injection-guidelines.md +++ b/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 diff --git a/docs/core/project-sdk/overview.md b/docs/core/project-sdk/overview.md index 259cc52cd30e5..5827425149c38 100644 --- a/docs/core/project-sdk/overview.md +++ b/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 diff --git a/docs/core/resources/manifest-file-names.md b/docs/core/resources/manifest-file-names.md index dbe224b8e7275..8bd79fcd4b6d4 100644 --- a/docs/core/resources/manifest-file-names.md +++ b/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: concept-article --- # How resource manifest files are named diff --git a/docs/core/runtime-config/index.md b/docs/core/runtime-config/index.md index c354266543500..045b6b085e3a9 100644 --- a/docs/core/runtime-config/index.md +++ b/docs/core/runtime-config/index.md @@ -1,7 +1,7 @@ --- title: .NET Runtime config options description: Learn how to configure the .NET runtime using configuration settings. -ms.topic: conceptual +ms.topic: concept-article ms.date: 07/23/2021 --- # .NET runtime configuration settings diff --git a/docs/csharp/how-to/index.md b/docs/csharp/how-to/index.md index 6149fe9c82588..73ff1e78e0ce5 100644 --- a/docs/csharp/how-to/index.md +++ b/docs/csharp/how-to/index.md @@ -1,7 +1,7 @@ --- title: How to articles description: A collection of quick tips and short, focused code samples -ms.topic: conceptual +ms.topic: concept-article ms.date: 12/20/2017 --- diff --git a/docs/csharp/linq/index.md b/docs/csharp/linq/index.md index 7ffe69058060c..4441b65d5de44 100644 --- a/docs/csharp/linq/index.md +++ b/docs/csharp/linq/index.md @@ -1,7 +1,7 @@ --- title: Language Integrated Query (LINQ) description: Introduces Language Integrated Query (LINQ) in C#. -ms.topic: conceptual +ms.topic: concept-article ms.date: 12/14/2023 --- # Language Integrated Query (LINQ) diff --git a/docs/framework/additional-apis/index.md b/docs/framework/additional-apis/index.md index 19e518740187b..70f45cd59e4c2 100644 --- a/docs/framework/additional-apis/index.md +++ b/docs/framework/additional-apis/index.md @@ -8,7 +8,7 @@ helpviewer_keywords: - ".NET Framework out-of-band releases" - "out-of-band releases" ms.assetid: cf2d9006-b631-4e5d-81cd-20aab78c60f1 -ms.topic: conceptual +ms.topic: concept-article --- # Additional class libraries and APIs diff --git a/docs/fundamentals/languages.md b/docs/fundamentals/languages.md index 36a0dd0782b00..31ade63a0e74d 100644 --- a/docs/fundamentals/languages.md +++ b/docs/fundamentals/languages.md @@ -4,7 +4,7 @@ description: Each .NET language is unique. C# is the most widely used language a author: billwagner ms.author: wiwagn ms.date: 02/06/2023 -ms.topic: conceptual +ms.topic: concept-article --- # Microsoft .NET language strategy diff --git a/docs/fundamentals/runtime-libraries/system-globalization-compareinfo.md b/docs/fundamentals/runtime-libraries/system-globalization-compareinfo.md index ad66e6081f817..83808127df575 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-compareinfo.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-compareinfo.md @@ -2,7 +2,7 @@ title: System.Globalization.CompareInfo class description: Learn more about the System.Globalization.CompareInfo class. ms.date: 12/28/2023 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/fundamentals/runtime-libraries/system-globalization-compareoptions.md b/docs/fundamentals/runtime-libraries/system-globalization-compareoptions.md index d28bf5b23fc14..d970a688afb51 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-compareoptions.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-compareoptions.md @@ -2,7 +2,7 @@ title: System.Globalization.CompareOptions enum description: Learn more about the System.Globalization.CompareOptions enum. ms.date: 12/28/2023 -ms.topic: conceptual +ms.topic: concept-article --- # enum diff --git a/docs/fundamentals/runtime-libraries/system-globalization-cultureandregioninfobuilder.md b/docs/fundamentals/runtime-libraries/system-globalization-cultureandregioninfobuilder.md index a613b864afeb8..af7a426bc7746 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-cultureandregioninfobuilder.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-cultureandregioninfobuilder.md @@ -2,7 +2,7 @@ title: System.Globalization.CultureAndRegionInfoBuilder class description: Learn more about the System.Globalization.CultureAndRegionInfoBuilder class. ms.date: 01/09/2024 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/fundamentals/runtime-libraries/system-globalization-cultureinfo.md b/docs/fundamentals/runtime-libraries/system-globalization-cultureinfo.md index 358d0796d9f01..8ff3fdd3a3fba 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-cultureinfo.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-cultureinfo.md @@ -2,7 +2,7 @@ title: System.Globalization.CultureInfo class description: Learn more about the System.Globalization.CultureInfo class. ms.date: 12/28/2023 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/fundamentals/runtime-libraries/system-globalization-datetimeformatinfo.md b/docs/fundamentals/runtime-libraries/system-globalization-datetimeformatinfo.md index 5eeb0f35e11a2..1b874c35ee4e6 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-datetimeformatinfo.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-datetimeformatinfo.md @@ -2,7 +2,7 @@ title: System.Globalization.DateTimeFormatInfo class description: Learn more about the System.Globalization.DateTimeFormatInfo class. ms.date: 12/28/2023 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/fundamentals/runtime-libraries/system-globalization-numberformatinfo.md b/docs/fundamentals/runtime-libraries/system-globalization-numberformatinfo.md index 242c0fb200a6a..da4bacbe3efc7 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-numberformatinfo.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-numberformatinfo.md @@ -2,7 +2,7 @@ title: System.Globalization.NumberFormatInfo class description: Learn more about the System.Globalization.NumberFormatInfo class. ms.date: 12/28/2023 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/fundamentals/runtime-libraries/system-globalization-persiancalendar.md b/docs/fundamentals/runtime-libraries/system-globalization-persiancalendar.md index 9fc0b310e8b13..9bfc3e59e7d25 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-persiancalendar.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-persiancalendar.md @@ -2,7 +2,7 @@ title: System.Globalization.PersianCalendar class description: Learn more about the System.Globalization.PersianCalendar class. ms.date: 04/09/2025 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/fundamentals/runtime-libraries/system-globalization-regioninfo.md b/docs/fundamentals/runtime-libraries/system-globalization-regioninfo.md index 67ef3c6bdb99f..56f65d756666e 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-regioninfo.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-regioninfo.md @@ -2,7 +2,7 @@ title: System.Globalization.RegionInfo class description: Learn more about the System.Globalization.RegionInfo class. ms.date: 12/28/2023 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/fundamentals/runtime-libraries/system-globalization-sortkey.md b/docs/fundamentals/runtime-libraries/system-globalization-sortkey.md index 45bbf16ca063b..4599f84e597af 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-sortkey.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-sortkey.md @@ -2,7 +2,7 @@ title: System.Globalization.SortKey class description: Learn more about the System.Globalization.SortKey class. ms.date: 12/28/2023 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/fundamentals/runtime-libraries/system-globalization-sortversion.md b/docs/fundamentals/runtime-libraries/system-globalization-sortversion.md index b2b6d6da28adb..5859726b6d155 100644 --- a/docs/fundamentals/runtime-libraries/system-globalization-sortversion.md +++ b/docs/fundamentals/runtime-libraries/system-globalization-sortversion.md @@ -2,7 +2,7 @@ title: System.Globalization.SortVersion class description: Learn more about the System.Globalization.SortVersion class. ms.date: 12/28/2023 -ms.topic: conceptual +ms.topic: concept-article --- # class diff --git a/docs/machine-learning/resources/ml-net-cli-telemetry.md b/docs/machine-learning/resources/ml-net-cli-telemetry.md index d24ef69509019..7d15eb96c6ad2 100644 --- a/docs/machine-learning/resources/ml-net-cli-telemetry.md +++ b/docs/machine-learning/resources/ml-net-cli-telemetry.md @@ -1,7 +1,7 @@ --- title: Telemetry collection by ML.NET CLI description: Learn about ML.NET CLI telemetry features that collect usage information for analysis, which data is collected, and how to disable it. Also, find links to the .NET license agreement and information about Microsoft GDPR compliance. -ms.topic: conceptual +ms.topic: concept-article ms.date: 06/03/2020 ms.custom: mlnet-tooling --- diff --git a/docs/standard/base-types/basic-string-operations.md b/docs/standard/base-types/basic-string-operations.md index f263e83e4edfc..aac44d7a3de49 100644 --- a/docs/standard/base-types/basic-string-operations.md +++ b/docs/standard/base-types/basic-string-operations.md @@ -2,7 +2,7 @@ title: Basic String Operations in .NET description: Learn about the basic operations that you can perform on strings. ms.date: "03/30/2017" -ms.topic: conceptual +ms.topic: concept-article helpviewer_keywords: - "strings [.NET], basic string operations" - "custom strings" diff --git a/docs/standard/base-types/best-practices-display-data.md b/docs/standard/base-types/best-practices-display-data.md index 5f8b81f013645..ae00d66517164 100644 --- a/docs/standard/base-types/best-practices-display-data.md +++ b/docs/standard/base-types/best-practices-display-data.md @@ -2,7 +2,7 @@ title: Best practices for displaying and persisting formatted data in .NET description: Learn how to display and persist numeric and date data effectively in .NET applications. ms.date: 05/01/2019 -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/best-practices-regex.md b/docs/standard/base-types/best-practices-regex.md index d9faa83c748e4..032ff0d8d21a6 100644 --- a/docs/standard/base-types/best-practices-regex.md +++ b/docs/standard/base-types/best-practices-regex.md @@ -3,7 +3,7 @@ title: Best Practices for Regular Expressions in .NET description: Learn how to create efficient, effective regular expressions in .NET. ms.date: 06/11/2024 ms.custom: devdivchpfy22 -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/best-practices-strings.md b/docs/standard/base-types/best-practices-strings.md index 9806fcb144a13..9e34506a29125 100644 --- a/docs/standard/base-types/best-practices-strings.md +++ b/docs/standard/base-types/best-practices-strings.md @@ -2,7 +2,7 @@ title: "Best Practices for Comparing Strings in .NET" description: Learn how to compare strings effectively in .NET applications. ms.date: 01/26/2023 -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/character-encoding-introduction.md b/docs/standard/base-types/character-encoding-introduction.md index 44e88abf1cbc4..4812e685771e1 100644 --- a/docs/standard/base-types/character-encoding-introduction.md +++ b/docs/standard/base-types/character-encoding-introduction.md @@ -2,7 +2,7 @@ title: Introduction to character encoding in .NET description: Learn about character encoding and decoding in .NET. ms.date: 10/22/2024 -ms.topic: conceptual +ms.topic: concept-article no-loc: [Rune, char, string] dev_langs: - "csharp" diff --git a/docs/standard/base-types/character-escapes-in-regular-expressions.md b/docs/standard/base-types/character-escapes-in-regular-expressions.md index 62bddf7331b2c..74fe61954e409 100644 --- a/docs/standard/base-types/character-escapes-in-regular-expressions.md +++ b/docs/standard/base-types/character-escapes-in-regular-expressions.md @@ -2,7 +2,7 @@ title: Character Escapes in .NET Regular Expressions description: Learn about special characters and escaped characters in .NET regular expressions. ms.date: "03/30/2017" -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/choosing-between-anonymous-and-tuple.md b/docs/standard/base-types/choosing-between-anonymous-and-tuple.md index 4ef0beb81fa98..8dc9b13761ec6 100644 --- a/docs/standard/base-types/choosing-between-anonymous-and-tuple.md +++ b/docs/standard/base-types/choosing-between-anonymous-and-tuple.md @@ -3,7 +3,7 @@ title: Choosing between anonymous and tuple types description: Learn when it's appropriate to choose between anonymous types, and tuple type. author: IEvangelist ms.author: dapine -ms.topic: conceptual +ms.topic: concept-article ms.date: 07/01/2020 --- # Choosing between anonymous and tuple types diff --git a/docs/standard/base-types/common-type-system.md b/docs/standard/base-types/common-type-system.md index 4c76f8711be56..52a4b0e269021 100644 --- a/docs/standard/base-types/common-type-system.md +++ b/docs/standard/base-types/common-type-system.md @@ -2,7 +2,7 @@ title: Common Type System description: Explore the type system in .NET. Read about types in .NET (value types or reference types), type definition, type members, and type member characteristics. ms.date: 01/03/2024 -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/comparing.md b/docs/standard/base-types/comparing.md index 97213ffcd01e3..dc80013d4b046 100644 --- a/docs/standard/base-types/comparing.md +++ b/docs/standard/base-types/comparing.md @@ -2,7 +2,7 @@ title: "Comparing Strings in .NET" description: Read about methods to compare strings in .NET. Learn about the Compare, CompareOrdinal, CompareTo, StartsWith, EndsWith, Equals, IndexOf, & LastIndexOf methods. ms.date: "03/30/2017" -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/compilation-and-reuse-in-regular-expressions.md b/docs/standard/base-types/compilation-and-reuse-in-regular-expressions.md index 39d27a346fb5b..480e0fbfa46f1 100644 --- a/docs/standard/base-types/compilation-and-reuse-in-regular-expressions.md +++ b/docs/standard/base-types/compilation-and-reuse-in-regular-expressions.md @@ -1,7 +1,7 @@ --- title: "Compilation and Reuse in Regular Expressions" description: "Learn about compilation and reuse in Regular Expressions." -ms.topic: conceptual +ms.topic: concept-article ms.date: 06/11/2024 helpviewer_keywords: - "parsing text with regular expressions, compilation" diff --git a/docs/standard/base-types/composite-formatting.md b/docs/standard/base-types/composite-formatting.md index 189b85c720ce3..5e37ee4bba0b8 100644 --- a/docs/standard/base-types/composite-formatting.md +++ b/docs/standard/base-types/composite-formatting.md @@ -2,7 +2,7 @@ title: Composite formatting description: Learn about .NET composite formatting, which takes as input a list of objects and a composite format string, containing fixed text with indexed placeholders. ms.date: 08/07/2023 -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/details-of-regular-expression-behavior.md b/docs/standard/base-types/details-of-regular-expression-behavior.md index 878576fdfa857..236a10ff70c7a 100644 --- a/docs/standard/base-types/details-of-regular-expression-behavior.md +++ b/docs/standard/base-types/details-of-regular-expression-behavior.md @@ -2,7 +2,7 @@ description: "Learn more about: Details of regular expression behavior" title: Regular Expression behavior ms.date: "03/30/2017" -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md b/docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md index 28d8dea1bdb38..d7b669b50d714 100644 --- a/docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md +++ b/docs/standard/base-types/miscellaneous-constructs-in-regular-expressions.md @@ -2,7 +2,7 @@ description: "Learn more about: Miscellaneous Constructs in Regular Expressions" title: "Miscellaneous Constructs in Regular Expressions" ms.date: "03/30/2017" -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/parsing-strings.md b/docs/standard/base-types/parsing-strings.md index e4015b0b40b05..010ea55ab87dc 100644 --- a/docs/standard/base-types/parsing-strings.md +++ b/docs/standard/base-types/parsing-strings.md @@ -2,7 +2,7 @@ title: "Convert strings to types" description: Understand string parsing in .NET. Parsing converts a string representing a .NET base type into that base type. Parsing is the reverse operation to formatting. ms.date: "03/30/2017" -ms.topic: conceptual +ms.topic: concept-article helpviewer_keywords: - "parsing strings, about parsing strings" - "IFormatProvider interface, parsing strings" diff --git a/docs/standard/base-types/quantifiers-in-regular-expressions.md b/docs/standard/base-types/quantifiers-in-regular-expressions.md index db67610ebd3b4..26d346f869740 100644 --- a/docs/standard/base-types/quantifiers-in-regular-expressions.md +++ b/docs/standard/base-types/quantifiers-in-regular-expressions.md @@ -3,7 +3,7 @@ title: "Quantifiers in Regular Expressions" description: Learn about regular expression quantifiers, which specify how many instances of a character, group, or character class must be present in the input to match. ms.date: "08/09/2022" ms.custom: devdivchpfy22 -ms.topic: conceptual +ms.topic: concept-article dev_langs: - "csharp" - "vb" diff --git a/docs/standard/base-types/regular-expression-source-generators.md b/docs/standard/base-types/regular-expression-source-generators.md index bf9c6881f6672..afdef23382edf 100644 --- a/docs/standard/base-types/regular-expression-source-generators.md +++ b/docs/standard/base-types/regular-expression-source-generators.md @@ -1,7 +1,7 @@ --- title: ".NET regular expression source generators" description: Learn how to use regular expression source generators to optimize the performance of matching algorithms in .NET. -ms.topic: conceptual +ms.topic: concept-article ms.date: 05/29/2024 author: IEvangelist ms.author: dapine diff --git a/docs/standard/base-types/regular-expressions.md b/docs/standard/base-types/regular-expressions.md index 9b2b18ef0b387..d23bb6d9c1275 100644 --- a/docs/standard/base-types/regular-expressions.md +++ b/docs/standard/base-types/regular-expressions.md @@ -1,7 +1,7 @@ --- title: ".NET Regular Expressions" description: Use regular expressions to find specific character patterns, validate text, work with text substrings, & add extracted strings to a collection in .NET. -ms.topic: conceptual +ms.topic: concept-article ms.date: "07/26/2022" ms.custom: devdivchpfy22 dev_langs: diff --git a/docs/standard/base-types/string-comparison-net-5-plus.md b/docs/standard/base-types/string-comparison-net-5-plus.md index a63e7a9accbf8..31d2c834b06ae 100644 --- a/docs/standard/base-types/string-comparison-net-5-plus.md +++ b/docs/standard/base-types/string-comparison-net-5-plus.md @@ -1,7 +1,7 @@ --- title: Behavior changes when comparing strings on .NET 5+ description: Learn about string-comparison behavior changes in .NET 5 and later versions on Windows. -ms.topic: conceptual +ms.topic: concept-article ms.date: 02/15/2022 --- diff --git a/docs/standard/base-types/substitutions-in-regular-expressions.md b/docs/standard/base-types/substitutions-in-regular-expressions.md index 0a6bbe9fbe416..4e291d8aa205b 100644 --- a/docs/standard/base-types/substitutions-in-regular-expressions.md +++ b/docs/standard/base-types/substitutions-in-regular-expressions.md @@ -1,7 +1,7 @@ --- title: "Substitutions in Regular Expressions" description: Make substitutions to replace matched text using regular expressions in .NET. Substitutions are language elements recognized only within replacement patterns. -ms.topic: conceptual +ms.topic: concept-article ms.date: "03/30/2017" dev_langs: - "csharp" diff --git a/docs/standard/base-types/the-regular-expression-object-model.md b/docs/standard/base-types/the-regular-expression-object-model.md index 6fda51c5d4b7d..416160e1d1087 100644 --- a/docs/standard/base-types/the-regular-expression-object-model.md +++ b/docs/standard/base-types/the-regular-expression-object-model.md @@ -1,7 +1,7 @@ --- title: "The Regular Expression Object Model" description: Review the regular expression object model in .NET. Work with the regular expression engine, & objects & collections related to matching, grouping, & capturing. -ms.topic: conceptual +ms.topic: concept-article ms.date: "03/30/2017" dev_langs: - "csharp" diff --git a/docs/standard/base-types/type-conversion.md b/docs/standard/base-types/type-conversion.md index 3199316672cff..7f667f5c85e4f 100644 --- a/docs/standard/base-types/type-conversion.md +++ b/docs/standard/base-types/type-conversion.md @@ -1,7 +1,7 @@ --- title: "Type Conversion in .NET" description: Read about type conversion in .NET, which creates a value in a new type that's equivalent to the old type's value, but may not keep the original's identity. -ms.topic: conceptual +ms.topic: concept-article ms.date: 03/30/2017 dev_langs: - "csharp" diff --git a/docs/standard/commandline/syntax.md b/docs/standard/commandline/syntax.md index 79648d416fd72..23c8cea903a94 100644 --- a/docs/standard/commandline/syntax.md +++ b/docs/standard/commandline/syntax.md @@ -7,7 +7,7 @@ helpviewer_keywords: - "command line interface" - "command line" - "System.CommandLine" -ms.topic: conceptual +ms.topic: concept-article --- # Command-line syntax overview for System.CommandLine diff --git a/docs/standard/serialization/system-text-json/fields.md b/docs/standard/serialization/system-text-json/fields.md index d82aca15623ea..ccdd4c907e3cd 100644 --- a/docs/standard/serialization/system-text-json/fields.md +++ b/docs/standard/serialization/system-text-json/fields.md @@ -6,7 +6,7 @@ no-loc: [System.Text.Json, Newtonsoft.Json] dev_langs: - "csharp" - "vb" -ms.topic: conceptual +ms.topic: concept-article --- # Include fields