Merge pull request #32086 from dotnet/main

Author: BillWagner

docs/architecture/microservices/architect-microservice-container-applications/asynchronous-message-based-communication.md

@@ -76,6 +76,8 @@ A challenge when implementing an event-driven architecture across multiple micro
 
 - Using the [Outbox pattern](https://www.kamilgrzybek.com/design/the-outbox-pattern/): a transactional database table as a message queue that will be the base for an event-creator component that would create the event and publish it.
 
+For a more complete description of the challenges in this space, including how messages with potentially incorrect data can end up being published, see [Data platform for mission-critical workloads on Azure: Every message must be processed](/azure/architecture/reference-architectures/containers/aks-mission-critical/mission-critical-data-platform#every-message-must-be-processed).
+
 Additional topics to consider when using asynchronous communication are message idempotence and message deduplication. These topics are covered in the section [Implementing event-based communication between microservices (integration events)](../multi-container-microservice-net-applications/integration-event-based-microservice-communications.md) later in this guide.
 
 ## Additional resources

docs/azure/includes/dotnet-all.md

@@ -72,7 +72,7 @@
 | Synapse - Spark | NuGet [1.0.0-preview.8](https://www.nuget.org/packages/Azure.Analytics.Synapse.Spark/1.0.0-preview.8) |  | GitHub [1.0.0-preview.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.Spark_1.0.0-preview.8/sdk/synapse/Azure.Analytics.Synapse.Spark/) |
 | Tables | NuGet [12.6.1](https://www.nuget.org/packages/Azure.Data.Tables/12.6.1)<br>NuGet [12.7.0-beta.1](https://www.nuget.org/packages/Azure.Data.Tables/12.7.0-beta.1) | [docs](/dotnet/api/overview/azure/Data.Tables-readme) | GitHub [12.6.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.Tables_12.6.1/sdk/tables/Azure.Data.Tables/)<br>GitHub [12.7.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.Tables_12.7.0-beta.1/sdk/tables/Azure.Data.Tables/) |
 | Text Analytics | NuGet [5.2.0](https://www.nuget.org/packages/Azure.AI.TextAnalytics/5.2.0) | [docs](/dotnet/api/overview/azure/AI.TextAnalytics-readme) | GitHub [5.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.TextAnalytics_5.2.0/sdk/textanalytics/Azure.AI.TextAnalytics/) |
-| Web PubSub | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.0.0)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/Messaging.WebPubSub-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.0.0/sdk/webpubsub/Azure.Messaging.WebPubSub/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.1.0-beta.1/sdk/webpubsub/Azure.Messaging.WebPubSub/) |
+| Web PubSub | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.1.0) | [docs](/dotnet/api/overview/azure/Messaging.WebPubSub-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.1.0/sdk/webpubsub/Azure.Messaging.WebPubSub/) |
 | Azure Functions extension for Azure Table service | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Tables/1.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebJobs.Extensions.Tables-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebJobs.Extensions.Tables_1.0.0/sdk/tables/Microsoft.Azure.WebJobs.Extensions.Tables/) |
 | CloudNative CloudEvents with Event Grid  | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents/1.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents_1.0.0/sdk/eventgrid/Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents/) |
 | Core - Client - Spatial | NuGet [1.1.0](https://www.nuget.org/packages/Microsoft.Azure.Core.Spatial/1.1.0)<br>NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Microsoft.Azure.Core.Spatial/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Core.Spatial-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.Spatial_1.1.0/sdk/core/Microsoft.Azure.Core.Spatial/)<br>GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.Spatial_1.2.0-beta.1/sdk/core/Microsoft.Azure.Core.Spatial/) |
@@ -376,7 +376,7 @@
 | Cosmos DB | NuGet [4.0.0-preview3](https://www.nuget.org/packages/Azure.Cosmos/4.0.0-preview3) | [docs](/dotnet/api/azure.cosmos) | GitHub [4.0.0-preview3](https://github.com/Azure/azure-cosmos-dotnet-v3/tree/releases/4.0.0-preview3) |
 | Cosmos DB | NuGet [3.31.0](https://www.nuget.org/packages/Microsoft.Azure.Cosmos/3.31.0) | [docs](/dotnet/api/overview/azure/cosmosdb) | GitHub [3.31.0](https://github.com/Azure/azure-cosmos-dotnet-v3/tree/3.12.0/Microsoft.Azure.Cosmos) |
 | Cosmos DB - BulkExecutor | NuGet [2.5.1-preview](https://www.nuget.org/packages/Microsoft.Azure.CosmosDB.BulkExecutor/2.5.1-preview) |  | GitHub [2.5.1-preview](https://github.com/Azure/azure-cosmosdb-bulkexecutor-dotnet-getting-started) |
-| Cosmos DB - Direct | NuGet [3.29.3](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Direct/3.29.3) |  | GitHub [3.29.3](https://github.com/Azure/azure-cosmos-dotnet-v3) |
+| Cosmos DB - Direct | NuGet [3.29.4](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Direct/3.29.4) |  | GitHub [3.29.4](https://github.com/Azure/azure-cosmos-dotnet-v3) |
 | Cosmos DB - Encryption | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Encryption/2.0.0) |  | GitHub [2.0.0](https://github.com/Azure/azure-cosmos-dotnet-v3/tree/releases/encryption/1.0.0-preview4/Microsoft.Azure.Cosmos.Encryption) |
 | Custom Image Search | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Search.CustomImageSearch/2.0.0) |  |  |
 | Custom Search | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Search.CustomSearch/2.0.0) |  |  |
@@ -536,7 +536,7 @@
 | Wastorage - Redist | NuGet [2.0.0](https://www.nuget.org/packages/wastorage.redist/2.0.0) |  |  |
 | Web - Redis Output Cache Provider | NuGet [3.0.1](https://www.nuget.org/packages/Microsoft.Web.RedisOutputCacheProvider/3.0.1) |  | GitHub [3.0.1](https://github.com/Azure/aspnet-redis-providers/tree/NuGet-Release/RedisOutputCacheProvider-3.0.1/src/OutputCacheProvider) |
 | Web - Redis Session State Provider | NuGet [4.0.1](https://www.nuget.org/packages/Microsoft.Web.RedisSessionStateProvider/4.0.1) |  | GitHub [4.0.1](https://github.com/Azure/aspnet-redis-providers/tree/NuGet-Release/RedisSessionStateProvider-4.0.1/src/RedisSessionStateProvider) |
-| Web PubSub | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.0.0)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/Messaging.WebPubSub-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.0.0/sdk/webpubsub/Azure.Messaging.WebPubSub/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.1.0-beta.1/sdk/webpubsub/Azure.Messaging.WebPubSub/) |
+| Web PubSub | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.1.0) | [docs](/dotnet/api/overview/azure/Messaging.WebPubSub-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.1.0/sdk/webpubsub/Azure.Messaging.WebPubSub/) |
 | Web Search | NuGet [2.0.0](https://www.nuget.org/packages/Microsoft.Azure.CognitiveServices.Search.WebSearch/2.0.0) |  |  |
 | WebJobs | NuGet [3.0.33](https://www.nuget.org/packages/Microsoft.Azure.WebJobs/3.0.33) |  | GitHub [3.0.33](https://github.com/Azure/azure-webjobs-sdk/tree/v3.0.18/src/Microsoft.Azure.WebJobs) |
 | WebJobs - Core | NuGet [3.0.33](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Core/3.0.33) |  | GitHub [3.0.33](https://github.com/Azure/azure-webjobs-sdk/tree/v3.0.18) |

docs/azure/includes/dotnet-new.md

@@ -72,7 +72,7 @@
 | Synapse - Spark | NuGet [1.0.0-preview.8](https://www.nuget.org/packages/Azure.Analytics.Synapse.Spark/1.0.0-preview.8) |  | GitHub [1.0.0-preview.8](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.Synapse.Spark_1.0.0-preview.8/sdk/synapse/Azure.Analytics.Synapse.Spark/) |
 | Tables | NuGet [12.6.1](https://www.nuget.org/packages/Azure.Data.Tables/12.6.1)<br>NuGet [12.7.0-beta.1](https://www.nuget.org/packages/Azure.Data.Tables/12.7.0-beta.1) | [docs](/dotnet/api/overview/azure/Data.Tables-readme) | GitHub [12.6.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.Tables_12.6.1/sdk/tables/Azure.Data.Tables/)<br>GitHub [12.7.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Data.Tables_12.7.0-beta.1/sdk/tables/Azure.Data.Tables/) |
 | Text Analytics | NuGet [5.2.0](https://www.nuget.org/packages/Azure.AI.TextAnalytics/5.2.0) | [docs](/dotnet/api/overview/azure/AI.TextAnalytics-readme) | GitHub [5.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.TextAnalytics_5.2.0/sdk/textanalytics/Azure.AI.TextAnalytics/) |
-| Web PubSub | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.0.0)<br>NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/Messaging.WebPubSub-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.0.0/sdk/webpubsub/Azure.Messaging.WebPubSub/)<br>GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.1.0-beta.1/sdk/webpubsub/Azure.Messaging.WebPubSub/) |
+| Web PubSub | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Messaging.WebPubSub/1.1.0) | [docs](/dotnet/api/overview/azure/Messaging.WebPubSub-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Messaging.WebPubSub_1.1.0/sdk/webpubsub/Azure.Messaging.WebPubSub/) |
 | Azure Functions extension for Azure Table service | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Tables/1.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.WebJobs.Extensions.Tables-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.WebJobs.Extensions.Tables_1.0.0/sdk/tables/Microsoft.Azure.WebJobs.Extensions.Tables/) |
 | CloudNative CloudEvents with Event Grid  | NuGet [1.0.0](https://www.nuget.org/packages/Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents/1.0.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents_1.0.0/sdk/eventgrid/Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents/) |
 | Core - Client - Spatial | NuGet [1.1.0](https://www.nuget.org/packages/Microsoft.Azure.Core.Spatial/1.1.0)<br>NuGet [1.2.0-beta.1](https://www.nuget.org/packages/Microsoft.Azure.Core.Spatial/1.2.0-beta.1) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Core.Spatial-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.Spatial_1.1.0/sdk/core/Microsoft.Azure.Core.Spatial/)<br>GitHub [1.2.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Core.Spatial_1.2.0-beta.1/sdk/core/Microsoft.Azure.Core.Spatial/) |

docs/core/extensions/logging.md

@@ -471,8 +471,12 @@ Use a scope by wrapping logger calls in a `using` block:
 public async Task<T> GetAsync<T>(string id)
 {
     T result;
+    var transactionId = Guid.NewGuid().ToString();
 
-    using (_logger.BeginScope("using block message"))
+    using (_logger.BeginScope(new List<KeyValuePair<string, object>>
+        {
+            new KeyValuePair<string, object>("TransactionId", transactionId),
+        }))
     {
         _logger.LogInformation(
             AppLogEvents.Read, "Reading value for {Id}", id);

docs/csharp/misc/sorry-we-don-t-have-specifics-on-this-csharp-error.md

@@ -592,6 +592,117 @@ f1_keywords:
   - "CS8902"
   - "CS8903"
   - "CS8904"
+  - "CS8978"
+  - "CS8979"
+  - "CS8980"
+  - "CS8982"
+  - "CS8983"
+  - "CS8984"
+  - "CS8985"
+  - "CS8986"
+  - "CS8987"
+  - "CS8988"
+  - "CS8989"
+  - "CS8996"
+  - "CS8997"
+  - "CS8998"
+  - "CS8999"
+  - "CS9000"
+  - "CS9001"
+  - "CS9002"
+  - "CS9003"
+  - "CS9004"
+  - "CS9005"
+  - "CS9006"
+  - "CS9007"
+  - "CS9008"
+  - "CS9009"
+  - "CS9010"
+  - "CS9011"
+  - "CS9012"
+  - "CS9013"
+  - "CS9014"
+  - "CS9015"
+  - "CS9016"
+  - "CS9017"
+  - "CS9018"
+  - "CS9019"
+  - "CS9020"
+  - "CS9021"
+  - "CS9022"
+  - "CS9023"
+  - "CS9024"
+  - "CS9025"
+  - "CS9026"
+  - "CS9027"
+  - "CS9028"
+  - "CS9029"
+  - "CS9030"
+  - "CS9031"
+  - "CS9032"
+  - "CS9033"
+  - "CS9034"
+  - "CS9035"
+  - "CS9036"
+  - "CS9037"
+  - "CS9038"
+  - "CS9039"
+  - "CS9040"
+  - "CS9041"
+  - "CS9042"
+  - "CS9044"
+  - "CS9045"
+  - "CS9046"
+  - "CS9047"
+  - "CS9048"
+  - "CS9049"
+  - "CS9051"
+  - "CS9052"
+  - "CS9053"
+  - "CS9054"
+  - "CS9055"
+  - "CS9056"
+  - "CS9057"
+  - "CS9058"
+  - "CS9059"
+  - "CS9060"
+  - "CS9061"
+  - "CS9062"
+  - "CS9063"
+  - "CS9064"
+  - "CS9065"
+  - "CS9066"
+  - "CS9067"
+  - "CS9068"
+  - "CS9069"
+  - "CS9070"
+  - "CS9071"
+  - "CS9072"
+  - "CS9073"
+  - "CS9074"
+  - "CS9075"
+  - "CS9076"
+  - "CS9077"
+  - "CS9078"
+  - "CS9079"
+  - "CS9080"
+  - "CS9081"
+  - "CS9082"
+  - "CS9083"
+  - "CS9084"
+  - "CS9085"
+  - "CS9086"
+  - "CS9087"
+  - "CS9088"
+  - "CS9089"
+  - "CS9090"
+  - "CS9091"
+  - "CS9092"
+  - "CS9093"
+  - "CS9094"
+  - "CS9095"
+  - "CS9096"
+  - "CS9097"
   - "CS9100"
 helpviewer_keywords:
   - "errors [C#], additional information"

docs/csharp/programming-guide/concepts/async/index.md

@@ -241,7 +241,6 @@ while (breakfastTasks.Count > 0)
     {
         Console.WriteLine("Toast is ready");
     }
-    await finishedTask;    
     breakfastTasks.Remove(finishedTask);
 }
 ```