Merge pull request #43792 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

docs/azure/includes/dotnet-all.md

@@ -249,7 +249,7 @@
 | Resource Management - Health Data AI Services | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.HealthDataAIServices/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HealthDataAIServices-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HealthDataAIServices_1.0.0/sdk/healthdataaiservices/Azure.ResourceManager.HealthDataAIServices/) |
 | Resource Management - Healthcare APIs | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.HealthcareApis/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HealthcareApis-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HealthcareApis_1.3.0/sdk/healthcareapis/Azure.ResourceManager.HealthcareApis/) |
 | Resource Management - Hybrid Compute | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.HybridCompute/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridCompute-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridCompute_1.0.0/sdk/hybridcompute/Azure.ResourceManager.HybridCompute/) |
-| Resource Management - Hybrid Connectivity | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.HybridConnectivity/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridConnectivity-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridConnectivity_1.0.0-beta.4/sdk/hybridconnectivity/Azure.ResourceManager.HybridConnectivity/) |
+| Resource Management - Hybrid Connectivity | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.HybridConnectivity/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridConnectivity-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridConnectivity_1.0.0/sdk/hybridconnectivity/Azure.ResourceManager.HybridConnectivity/) |
 | Resource Management - Hybrid Container Service | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.HybridContainerService/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridContainerService-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridContainerService_1.0.0/sdk/hybridaks/Azure.ResourceManager.HybridContainerService/) |
 | Resource Management - Hybrid Kubernetes | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.Kubernetes/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.Kubernetes-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Kubernetes_1.0.0-beta.4/sdk/hybridkubernetes/Azure.ResourceManager.Kubernetes/) |
 | Resource Management - Hybrid Network | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.HybridNetwork/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridNetwork-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridNetwork_1.0.0-beta.2/sdk/hybridnetwork/Azure.ResourceManager.HybridNetwork/) |
@@ -274,7 +274,7 @@
 | Resource Management - Managed Service Identity | NuGet [1.2.3](https://www.nuget.org/packages/Azure.ResourceManager.ManagedServiceIdentities/1.2.3)<br>NuGet [1.3.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ManagedServiceIdentities/1.3.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ManagedServiceIdentities-readme) | GitHub [1.2.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedServiceIdentities_1.2.3/sdk/managedserviceidentity/Azure.ResourceManager.ManagedServiceIdentities/)<br>GitHub [1.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedServiceIdentities_1.3.0-beta.1/sdk/managedserviceidentity/Azure.ResourceManager.ManagedServiceIdentities/) |
 | Resource Management - Managed Services | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ManagedServices/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ManagedServices-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedServices_1.1.0/sdk/managedservices/Azure.ResourceManager.ManagedServices/) |
 | Resource Management - Management Partner | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.ManagementPartner/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.ManagementPartner-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagementPartner_1.0.0-beta.4/sdk/managementpartner/Azure.ResourceManager.ManagementPartner/) |
-| Resource Management - Maps | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.0.1)<br>NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.Maps-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.0.1/sdk/maps/Azure.ResourceManager.Maps/)<br>GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.1.0-beta.3/sdk/maps/Azure.ResourceManager.Maps/) |
+| Resource Management - Maps | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Maps-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.1.0/sdk/maps/Azure.ResourceManager.Maps/) |
 | Resource Management - Marketplace | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Marketplace/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Marketplace-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Marketplace_1.1.1/sdk/marketplace/Azure.ResourceManager.Marketplace/) |
 | Resource Management - Marketplace Ordering | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.MarketplaceOrdering/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.MarketplaceOrdering-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MarketplaceOrdering_1.1.0/sdk/marketplaceordering/Azure.ResourceManager.MarketplaceOrdering/) |
 | Resource Management - Media | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Media/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Media-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Media_1.3.0/sdk/mediaservices/Azure.ResourceManager.Media/) |
@@ -485,8 +485,8 @@
 | Functions extension for Azure SQL and SQL Server | NuGet [3.1.284](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Sql/3.1.284) |  |  |
 | Functions extension for Cosmos DB | NuGet [4.8.1](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.CosmosDB/4.8.1) |  | GitHub [4.8.1](https://github.com/Azure/azure-webjobs-sdk-extensions/tree/cosmos-v3.0.7/src/WebJobs.Extensions.CosmosDB) |
 | Functions extension for DocumentDB | NuGet [1.3.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DocumentDB/1.3.0) |  | GitHub [1.3.0](https://github.com/Azure/azure-webjobs-sdk-extensions) |
-| Functions extension for Durable Task Framework | NuGet [3.0.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask/3.0.0) | [docs](https://learn.microsoft.com/dotnet/api/overview/azure/functions) | GitHub [3.0.0](https://github.com/Azure/azure-functions-durable-extension/tree/v2.2.2/src/WebJobs.Extensions.DurableTask) |
-| Functions extension for Durable Task Framework - isolated worker | NuGet [1.2.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask/1.2.0) |  |  |
+| Functions extension for Durable Task Framework | NuGet [3.0.1](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.DurableTask/3.0.1) | [docs](https://learn.microsoft.com/dotnet/api/overview/azure/functions) | GitHub [3.0.1](https://github.com/Azure/azure-functions-durable-extension/tree/v2.2.2/src/WebJobs.Extensions.DurableTask) |
+| Functions extension for Durable Task Framework - isolated worker | NuGet [1.2.1](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask/1.2.1) |  |  |
 | Functions extension for HTTP | NuGet [3.2.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Http/3.2.0) |  | GitHub [3.2.0](https://github.com/Azure/azure-webjobs-sdk-extensions/tree/v3.0.2/src/WebJobs.Extensions.Http) |
 | Functions extension for IoT Edge | NuGet [1.0.7](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.EdgeHub/1.0.7) |  | GitHub [1.0.7](https://github.com/Azure/iotedge/tree/1.0.7/edge-hub) |
 | Functions extension for Kafka | NuGet [4.0.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Kafka/4.0.0)<br>NuGet [4.1.0-preview3](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Kafka/4.1.0-preview3) |  | GitHub [4.0.0](https://github.com/Azure/azure-functions-kafka-extension/tree/3.0.0/src/Microsoft.Azure.WebJobs.Extensions.Kafka) |

docs/azure/includes/dotnet-new.md

@@ -255,7 +255,7 @@
 | Resource Management - Health Data AI Services | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.HealthDataAIServices/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HealthDataAIServices-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HealthDataAIServices_1.0.0/sdk/healthdataaiservices/Azure.ResourceManager.HealthDataAIServices/) |
 | Resource Management - Healthcare APIs | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.HealthcareApis/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HealthcareApis-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HealthcareApis_1.3.0/sdk/healthcareapis/Azure.ResourceManager.HealthcareApis/) |
 | Resource Management - Hybrid Compute | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.HybridCompute/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridCompute-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridCompute_1.0.0/sdk/hybridcompute/Azure.ResourceManager.HybridCompute/) |
-| Resource Management - Hybrid Connectivity | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.HybridConnectivity/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridConnectivity-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridConnectivity_1.0.0-beta.4/sdk/hybridconnectivity/Azure.ResourceManager.HybridConnectivity/) |
+| Resource Management - Hybrid Connectivity | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.HybridConnectivity/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridConnectivity-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridConnectivity_1.0.0/sdk/hybridconnectivity/Azure.ResourceManager.HybridConnectivity/) |
 | Resource Management - Hybrid Container Service | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.HybridContainerService/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridContainerService-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridContainerService_1.0.0/sdk/hybridaks/Azure.ResourceManager.HybridContainerService/) |
 | Resource Management - Hybrid Data | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.HybridData/1.0.1)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.HybridData/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.HybridData-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.HybridData_1.1.0-beta.1/sdk/hybriddatamanager/Azure.ResourceManager.HybridData) |
 | Resource Management - Hybrid Kubernetes | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.Kubernetes/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.Kubernetes-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Kubernetes_1.0.0-beta.4/sdk/hybridkubernetes/Azure.ResourceManager.Kubernetes/) |
@@ -281,7 +281,7 @@
 | Resource Management - Managed Service Identity | NuGet [1.2.3](https://www.nuget.org/packages/Azure.ResourceManager.ManagedServiceIdentities/1.2.3)<br>NuGet [1.3.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ManagedServiceIdentities/1.3.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ManagedServiceIdentities-readme) | GitHub [1.2.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedServiceIdentities_1.2.3/sdk/managedserviceidentity/Azure.ResourceManager.ManagedServiceIdentities/)<br>GitHub [1.3.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedServiceIdentities_1.3.0-beta.1/sdk/managedserviceidentity/Azure.ResourceManager.ManagedServiceIdentities/) |
 | Resource Management - Managed Services | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ManagedServices/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ManagedServices-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagedServices_1.1.0/sdk/managedservices/Azure.ResourceManager.ManagedServices/) |
 | Resource Management - Management Partner | NuGet [1.0.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.ManagementPartner/1.0.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.ManagementPartner-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ManagementPartner_1.0.0-beta.4/sdk/managementpartner/Azure.ResourceManager.ManagementPartner/) |
-| Resource Management - Maps | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.0.1)<br>NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.Maps-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.0.1/sdk/maps/Azure.ResourceManager.Maps/)<br>GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.1.0-beta.3/sdk/maps/Azure.ResourceManager.Maps/) |
+| Resource Management - Maps | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.Maps/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Maps-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Maps_1.1.0/sdk/maps/Azure.ResourceManager.Maps/) |
 | Resource Management - Marketplace | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Marketplace/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Marketplace-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Marketplace_1.1.1/sdk/marketplace/Azure.ResourceManager.Marketplace/) |
 | Resource Management - Marketplace Ordering | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.MarketplaceOrdering/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.MarketplaceOrdering-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.MarketplaceOrdering_1.1.0/sdk/marketplaceordering/Azure.ResourceManager.MarketplaceOrdering/) |
 | Resource Management - Media | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Media/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Media-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Media_1.3.0/sdk/mediaservices/Azure.ResourceManager.Media/) |

docs/core/testing/mstest-analyzers/mstest0037.md

@@ -0,0 +1,59 @@
+---
+title: "Use proper 'Assert' methods"
+description: "Learn about code analysis rule MSTEST0037: Use proper 'Assert' methods."
+ms.date: 11/17/2024
+f1_keywords:
+- MSTEST0037
+- UseProperAssertMethodsAnalyzer
+helpviewer_keywords:
+- UseProperAssertMethodsAnalyzer
+- MSTEST0037
+author: Youssef1313
+ms.author: ygerges
+---
+# MSTEST0037: Use proper 'Assert' methods
+
+| Property                            | Value                                                                  |
+|-------------------------------------|------------------------------------------------------------------------|
+| **Rule ID**                         | MSTEST0037                                                             |
+| **Title**                           | Use proper 'Assert' methods                                            |
+| **Category**                        | Usage                                                                  |
+| **Fix is breaking or non-breaking** | Non-breaking                                                           |
+| **Enabled by default**              | Yes                                                                    |
+| **Default severity**                | Info                                                                   |
+| **Introduced in version**           | 3.7.0                                                                  |
+| **There is a code fix**             | No                                                                     |
+
+## Cause
+
+The use of <xref:Microsoft.VisualStudio.TestTools.UnitTesting.Assert> methods in a specific way when there is a better alternative.
+
+## Rule description
+
+There are multiple cases where you get this warning:
+
+- The use of `Assert.IsTrue(<expression> == null)` (with all combinations, like `IsFalse`, `!= null`, `is null`, or `is not null`).
+
+    Using `Assert.IsNull(<expression>)` or `Assert.IsNotNull(<expression>)` is a better alternative.
+
+- The use of `Assert.IsTrue(<expression1> == <expression2>)` (with all combinations, like `IsFalse` or `!=`).
+
+    Using `Assert.AreEqual(<expression1>, <expression2>)` or `Assert.AreNotEqual(<expression1>, <expression2>)` is a better alternative.
+
+- The use of `Assert.AreEqual(true, <expression>)` or `Assert.AreEqual(false, <expression>)`.
+
+    Using `Assert.IsTrue(<expression>)` or `Assert.IsFalse(<expression>)` is a better alternative.
+
+- The use of `Assert.AreEqual(null, <expression>)` or `Assert.AreNotEqual(null, <expression>)`.
+
+    Using `Assert.IsNull(<expression>)` or `Assert.IsNotNull<expression>` is a better alternative.
+
+In many cases, the better alternatives provide better messages when they fail and are also easier to read.
+
+## How to fix violations
+
+Use the better alternative method.
+
+## When to suppress warnings
+
+You usually don't want to suppress warnings from this rule.

docs/core/testing/mstest-analyzers/usage-rules.md

@@ -27,3 +27,4 @@ Identifier | Name | Description
 [MSTEST0023](mstest0023.md) | DoNotNegateBooleanAssertionAnalyzer | Do not negate boolean assertions
 [MSTEST0024](mstest0024.md) | DoNotStoreStaticTestContextAnalyzer | Do not store TestContext in a static member
 [MSTEST0026](mstest0026.md) | AssertionArgsShouldAvoidConditionalAccessRuleId | Avoid conditional access in assertions
+[MSTEST0037](mstest0037.md) | UseProperAssertMethodsAnalyzer | Use proper `Assert` methods