Merge pull request #39657 from dotnet/main

docs/azure/includes/dotnet-all.md

@@ -134,7 +134,7 @@
 | Resource Management - Chaos | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Chaos/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Chaos-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Chaos_1.0.0/sdk/chaos/Azure.ResourceManager.Chaos/) |
 | Resource Management - Cognitive Services | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.CognitiveServices/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CognitiveServices-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CognitiveServices_1.3.1/sdk/cognitiveservices/Azure.ResourceManager.CognitiveServices/) |
 | Resource Management - Communication | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.Communication/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Communication-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Communication_1.2.0/sdk/communication/Azure.ResourceManager.Communication/) |
-| Resource Management - Compute | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.3.0)<br>NuGet [1.4.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.4.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.3.0/sdk/compute/Azure.ResourceManager.Compute/)<br>GitHub [1.4.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.4.0-beta.1/sdk/compute/Azure.ResourceManager.Compute/) |
+| Resource Management - Compute | NuGet [1.4.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.4.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.4.0/sdk/compute/Azure.ResourceManager.Compute/) |
 | Resource Management - Confidential Ledger | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.0.1)<br>NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.ConfidentialLedger-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.0.1/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/)<br>GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.1.0-beta.3/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/) |
 | Resource Management - Confluent | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.Confluent/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Confluent-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Confluent_1.1.0/sdk/confluent/Azure.ResourceManager.Confluent/) |
 | Resource Management - Connected VMware vSphere | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.ConnectedVMwarevSphere/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ConnectedVMwarevSphere-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConnectedVMwarevSphere_1.0.0/sdk/connectedvmwarevsphere/Azure.ResourceManager.ConnectedVMwarevSphere/) |
@@ -244,7 +244,7 @@
 | Resource Management - Recovery Services | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServices/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServices-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServices_1.1.1/sdk/recoveryservices/Azure.ResourceManager.RecoveryServices/) |
 | Resource Management - Recovery Services Backup | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServicesBackup/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServicesBackup-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServicesBackup_1.2.0/sdk/recoveryservices-backup/Azure.ResourceManager.RecoveryServicesBackup/) |
 | Resource Management - Recovery Services Data Replication | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServicesDataReplication/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServicesDataReplication-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServicesDataReplication_1.0.0-beta.2/sdk/recoveryservices-datareplication/Azure.ResourceManager.RecoveryServicesDataReplication/) |
-| Resource Management - Recovery Services Site Recovery | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServicesSiteRecovery/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServicesSiteRecovery-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServicesSiteRecovery_1.1.1/sdk/recoveryservices-siterecovery/Azure.ResourceManager.RecoveryServicesSiteRecovery/) |
+| Resource Management - Recovery Services Site Recovery | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServicesSiteRecovery/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServicesSiteRecovery-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServicesSiteRecovery_1.2.0/sdk/recoveryservices-siterecovery/Azure.ResourceManager.RecoveryServicesSiteRecovery/) |
 | Resource Management - Redis | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Redis/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Redis-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Redis_1.3.0/sdk/redis/Azure.ResourceManager.Redis/) |
 | Resource Management - Redis Enterprise | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.RedisEnterprise/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.RedisEnterprise-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RedisEnterprise_1.1.0/sdk/redisenterprise/Azure.ResourceManager.RedisEnterprise/) |
 | Resource Management - Redis Enterprise Cache | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.RedisEnterpriseCache/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.RedisEnterpriseCache-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RedisEnterpriseCache_1.0.0-beta.1/sdk/redisenterprise/Azure.ResourceManager.RedisEnterpriseCache/) |
@@ -350,7 +350,7 @@
 | LUIS Authoring | NuGet [3.1.0](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Language.LUIS.Authoring/3.1.0)<br>NuGet [3.2.0-preview.5](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Language.LUIS.Authoring/3.2.0-preview.5) |  | GitHub [3.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.CognitiveServices.Language.LUIS.Authoring_3.2.0-preview.3/sdk/cognitiveservices/Language.LUIS.Authoring) |
 | LUIS Runtime | NuGet [3.1.0-preview.1](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Language.LUIS.Runtime/3.1.0-preview.1) |  | GitHub [3.1.0-preview.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.CognitiveServices.Language.LUIS.Runtime_3.1.0-preview.1/sdk/cognitiveservices/Language.LUIS.Runtime) |
 | Media Live Video Analytics Edge | NuGet [1.0.4-preview.1](https://www.nuget.org/packages/Microsoft.Azure.Media.LiveVideoAnalytics.Edge/1.0.4-preview.1) |  | GitHub [1.0.4-preview.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Media.LiveVideoAnalytics.Edge_1.0.4-preview.1/sdk/mediaservices/Microsoft.Azure.Media.LiveVideoAnalytics.Edge) |
-| Microsoft.Azure.Amqp | NuGet [2.6.4](https://www.nuget.org/packages/Microsoft.Azure.Amqp/2.6.4) |  |  |
+| Microsoft.Azure.Amqp | NuGet [2.6.5](https://www.nuget.org/packages/Microsoft.Azure.Amqp/2.6.5) |  |  |
 | Microsoft.Azure.Devices | NuGet [1.39.1](https://www.nuget.org/packages/Microsoft.Azure.Devices/1.39.1)<br>NuGet [2.0.0-preview007](https://www.nuget.org/packages/Microsoft.Azure.Devices/2.0.0-preview007) |  |  |
 | Microsoft.Azure.Devices.Authentication | NuGet [2.0.0-preview001](https://www.nuget.org/packages/Microsoft.Azure.Devices.Authentication/2.0.0-preview001) |  |  |
 | Microsoft.Azure.Devices.Client.PCL | NuGet [1.0.16](https://www.nuget.org/packages/Microsoft.Azure.Devices.Client.PCL/1.0.16) |  |  |

docs/azure/includes/dotnet-new.md

@@ -136,7 +136,7 @@
 | Resource Management - Chaos | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.Chaos/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Chaos-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Chaos_1.0.0/sdk/chaos/Azure.ResourceManager.Chaos/) |
 | Resource Management - Cognitive Services | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.CognitiveServices/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.CognitiveServices-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.CognitiveServices_1.3.1/sdk/cognitiveservices/Azure.ResourceManager.CognitiveServices/) |
 | Resource Management - Communication | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.Communication/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Communication-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Communication_1.2.0/sdk/communication/Azure.ResourceManager.Communication/) |
-| Resource Management - Compute | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.3.0)<br>NuGet [1.4.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.4.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.3.0/sdk/compute/Azure.ResourceManager.Compute/)<br>GitHub [1.4.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.4.0-beta.1/sdk/compute/Azure.ResourceManager.Compute/) |
+| Resource Management - Compute | NuGet [1.4.0](https://www.nuget.org/packages/Azure.ResourceManager.Compute/1.4.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Compute-readme) | GitHub [1.4.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Compute_1.4.0/sdk/compute/Azure.ResourceManager.Compute/) |
 | Resource Management - Confidential Ledger | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.0.1)<br>NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.ConfidentialLedger/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.ConfidentialLedger-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.0.1/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/)<br>GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConfidentialLedger_1.1.0-beta.3/sdk/confidentialledger/Azure.ResourceManager.ConfidentialLedger/) |
 | Resource Management - Confluent | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.Confluent/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Confluent-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Confluent_1.1.0/sdk/confluent/Azure.ResourceManager.Confluent/) |
 | Resource Management - Connected VMware vSphere | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.ConnectedVMwarevSphere/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ConnectedVMwarevSphere-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConnectedVMwarevSphere_1.0.0/sdk/connectedvmwarevsphere/Azure.ResourceManager.ConnectedVMwarevSphere/) |
@@ -247,7 +247,7 @@
 | Resource Management - Recovery Services | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServices/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServices-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServices_1.1.1/sdk/recoveryservices/Azure.ResourceManager.RecoveryServices/) |
 | Resource Management - Recovery Services Backup | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServicesBackup/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServicesBackup-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServicesBackup_1.2.0/sdk/recoveryservices-backup/Azure.ResourceManager.RecoveryServicesBackup/) |
 | Resource Management - Recovery Services Data Replication | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServicesDataReplication/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServicesDataReplication-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServicesDataReplication_1.0.0-beta.2/sdk/recoveryservices-datareplication/Azure.ResourceManager.RecoveryServicesDataReplication/) |
-| Resource Management - Recovery Services Site Recovery | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServicesSiteRecovery/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServicesSiteRecovery-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServicesSiteRecovery_1.1.1/sdk/recoveryservices-siterecovery/Azure.ResourceManager.RecoveryServicesSiteRecovery/) |
+| Resource Management - Recovery Services Site Recovery | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.RecoveryServicesSiteRecovery/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.RecoveryServicesSiteRecovery-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RecoveryServicesSiteRecovery_1.2.0/sdk/recoveryservices-siterecovery/Azure.ResourceManager.RecoveryServicesSiteRecovery/) |
 | Resource Management - Redis | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Redis/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.Redis-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Redis_1.3.0/sdk/redis/Azure.ResourceManager.Redis/) |
 | Resource Management - Redis Enterprise | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.RedisEnterprise/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.RedisEnterprise-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RedisEnterprise_1.1.0/sdk/redisenterprise/Azure.ResourceManager.RedisEnterprise/) |
 | Resource Management - Redis Enterprise Cache | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.RedisEnterpriseCache/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.RedisEnterpriseCache-readme?view=azure-dotnet-preview&amp;preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.RedisEnterpriseCache_1.0.0-beta.1/sdk/redisenterprise/Azure.ResourceManager.RedisEnterpriseCache/) |

docs/core/diagnostics/diagnosticsource-diagnosticlistener.md

@@ -212,6 +212,22 @@ The `listener.Subscribe()` call in the previous example can be replaced with the
 This efficiently subscribes to only the 'RequestStart' events. All other events will cause the `DiagnosticSource.IsEnabled()`
 method to return `false` and thus be efficiently filtered out.
 
+> [!NOTE]
+> Filtering is only designed as a performance optimization. It is possible for a listener to receive events even when they
+> do not satisfy the filter. This could occur because some other listener has subscribed to the event or because the source
+> of the event didn't check IsEnabled() prior to sending it. If you want to be certain that a given event satisfies the filter
+> you will need to check it inside the callback. For example:
+
+```C#
+    Action<KeyValuePair<string, object>> callback = (KeyValuePair<string, object> evnt) =>
+        {
+            if(predicate(evnt.Key)) // only print out events that satisfy our filter
+            {
+                Console.WriteLine("From Listener {0} Received Event {1} with payload {2}", networkListener.Name, evnt.Key, evnt.Value.ToString());
+            }
+        };
+```
+
 ##### Context-based filtering
 
 Some scenarios require advanced filtering based on extended context.

docs/core/tools/dotnet-new-sdk-templates.md

@@ -3,7 +3,7 @@ title: .NET default templates for dotnet new
 description: The information about dotnet new templates shipped with dotnet SDK.
 ms.custom: updateeachrelease
 no-loc: [Blazor, WebAssembly]
-ms.date: 12/07/2023
+ms.date: 02/21/2024
 ---
 # .NET default templates for dotnet new
 
@@ -208,6 +208,8 @@ The ability to create a project for an earlier TFM depends on having that versio
 
 ## `blazorserver`
 
+**Discontinued since .NET 8 SDK.**
+
 - **`-au|--auth <AUTHENTICATION_TYPE>`**
 
   The type of authentication to use. The possible values are:
@@ -620,6 +622,8 @@ The ability to create a project for an earlier TFM depends on having that versio
 
 ## <a name="spa"></a> `angular`, `react`
 
+**Discontinued since .NET 8 SDK.**
+
 - **`-au|--auth <AUTHENTICATION_TYPE>`**
 
   The type of authentication to use. Available since .NET Core 3.0 SDK.
@@ -810,6 +814,20 @@ Creates a web API project with AOT publish enabled. For more information, see [N
 
 ***
 
+## `apicontroller`
+
+API Controller with or without read/write actions.
+
+- **`-p:n|--name <NAME>`**
+
+  The namespace for the generated code. Default is `MyApp.Namespace`.
+
+- **`-ac|--actions`**
+
+  Create a controller with read/write actions. Default is `false`.
+
+***
+
 ## `globaljson`
 
 - **`--sdk-version <VERSION_NUMBER>`**

docs/machine-learning/how-to-guides/ner-dataset-guide.md

@@ -0,0 +1,17 @@
+---
+title: How to format data for Named Entity Recognition (NER)
+description: Learn how to format data for Named Entity Recognition (NER) scenario in Model Builder
+ms.date: 02/23/2024
+author: zewditu
+ms.author: zehailem
+ms.custom: mvc,how-to
+ms.topic: how-to
+#Customer intent: As a non-developer, I want to be able to format training data for Model Builder to use for training NER scenarios
+---
+
+# How to format data for Named Entity Recognition (NER)
+
+NER dataset shapes:
+
+- **Key information file:** Containing a list of entities, which serves as key information for the training data.
+- **Training data:** Training data consists of a file (.txt, .tsv) containing columns separated by TAB. One of these columns is a sentence column, while the others represent labels for tokens within that sentence column.