From 6c62ee968af7f5ba5bddede4463151abd28f4720 Mon Sep 17 00:00:00 2001 From: David Pine Date: Mon, 29 Sep 2025 08:43:11 -0500 Subject: [PATCH 1/9] Fix project reference path in documentation (#48758) Updated project reference path in preprocessor directives documentation. --- docs/csharp/language-reference/preprocessor-directives.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/csharp/language-reference/preprocessor-directives.md b/docs/csharp/language-reference/preprocessor-directives.md index d93158c7ce056..46a9fc9cea794 100644 --- a/docs/csharp/language-reference/preprocessor-directives.md +++ b/docs/csharp/language-reference/preprocessor-directives.md @@ -115,7 +115,7 @@ The `#:` directives that are used in file-based apps include: Instances of `#:project` are translated into `ProjectReference` elements to include the project with the specified path to the project. For example: ```csharp - #:project ../Path/To.Example.csproj + #:project ../Path/To.Example ``` The preceding preprocessor token is translated into: From dc9f9f38bc04c5d645506ff22d4194f6060c3545 Mon Sep 17 00:00:00 2001 From: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com> Date: Mon, 29 Sep 2025 06:44:14 -0700 Subject: [PATCH 2/9] Update package index with latest published versions (#48756) --- docs/azure/includes/dotnet-all.md | 27 ++++++++++++++------------- docs/azure/includes/dotnet-new.md | 7 ++++--- 2 files changed, 18 insertions(+), 16 deletions(-) diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md index 635acb5d9e2a4..0f8e65b99175a 100644 --- a/docs/azure/includes/dotnet-all.md +++ b/docs/azure/includes/dotnet-all.md @@ -49,7 +49,7 @@ | FarmBeats | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.Verticals.AgriFood.Farming/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/Verticals.AgriFood.Farming-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Verticals.AgriFood.Farming_1.0.0-beta.2/sdk/agrifood/Azure.Verticals.AgriFood.Farming/) | | Form Recognizer | NuGet [4.1.0](https://www.nuget.org/packages/Azure.AI.FormRecognizer/4.1.0) | [docs](/dotnet/api/overview/azure/AI.FormRecognizer-readme) | GitHub [4.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.FormRecognizer_4.1.0/sdk/formrecognizer/Azure.AI.FormRecognizer/) | | Functions Extensions - WebPubSub | NuGet [1.7.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.WebPubSub/1.7.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Functions.Worker.Extensions.WebPubSub-readme) | GitHub [1.7.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Functions.Worker.Extensions.WebPubSub_1.7.0/sdk/webpubsub/Microsoft.Azure.Functions.Worker.Extensions.WebPubSub/) | -| Health Deidentification | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Health.Deidentification/1.0.0) | [docs](/dotnet/api/overview/azure/Health.Deidentification-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Deidentification_1.0.0/sdk/healthdataaiservices/Azure.Health.Deidentification/) | +| Health Deidentification | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Health.Deidentification/1.0.0)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.Health.Deidentification/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Deidentification-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Deidentification_1.0.0/sdk/healthdataaiservices/Azure.Health.Deidentification/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Deidentification_1.1.0-beta.1/sdk/healthdataaiservices/Azure.Health.Deidentification/) | | Health Insights Cancer Profiling | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Health.Insights.CancerProfiling/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Insights.CancerProfiling-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.CancerProfiling_1.0.0-beta.1/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/) | | Health Insights Clinical Matching | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Health.Insights.ClinicalMatching/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Insights.ClinicalMatching-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.ClinicalMatching_1.0.0-beta.1/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/) | | Health Insights Radiology Insights | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Health.Insights.RadiologyInsights/1.1.0) | [docs](/dotnet/api/overview/azure/Health.Insights.RadiologyInsights-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.RadiologyInsights_1.1.0/sdk/healthinsights/Azure.Health.Insights.RadiologyInsights/) | @@ -116,7 +116,7 @@ | Text Translation | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.Translation.Text/1.0.0) | [docs](/dotnet/api/overview/azure/AI.Translation.Text-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Translation.Text_1.0.0/sdk/translation/Azure.AI.Translation.Text/) | | Time Series Insights | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.IoT.TimeSeriesInsights/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/IoT.TimeSeriesInsights-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.IoT.TimeSeriesInsights_1.0.0-beta.1/sdk/timeseriesinsights/Azure.IoT.TimeSeriesInsights/) | | TimeZone | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Maps.TimeZones/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Maps.TimeZones-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Maps.TimeZones_1.0.0-beta.1/sdk/maps/Azure.Maps.TimeZones/) | -| unknown | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.VoiceLive/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.VoiceLive-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.VoiceLive_1.0.0-beta.2/sdk/ai/Azure.AI.VoiceLive/) | +| unknown | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.AI.VoiceLive/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/AI.VoiceLive-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.VoiceLive_1.0.0-beta.3/sdk/ai/Azure.AI.VoiceLive/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Analytics.OnlineExperimentation/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Analytics.OnlineExperimentation-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.OnlineExperimentation_1.0.0-beta.1/sdk/onlineexperimentation/Azure.Analytics.OnlineExperimentation/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Projects/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Projects-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Projects_1.0.0-beta.1/sdk/cloudmachine/Azure.Projects/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Projects.AI/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Projects.AI-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Projects.AI_1.0.0-beta.1/sdk/cloudmachine/Azure.Projects.AI/) | @@ -226,7 +226,7 @@ | Resource Management - Data Factory | NuGet [1.9.0](https://www.nuget.org/packages/Azure.ResourceManager.DataFactory/1.9.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DataFactory-readme) | GitHub [1.9.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataFactory_1.9.0/sdk/datafactory/Azure.ResourceManager.DataFactory/) | | Resource Management - Data Lake Analytics | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DataLakeAnalytics/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DataLakeAnalytics-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataLakeAnalytics_1.1.1/sdk/datalake-analytics/Azure.ResourceManager.DataLakeAnalytics/) | | Resource Management - Data Lake Store | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DataLakeStore/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DataLakeStore-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataLakeStore_1.1.1/sdk/datalake-store/Azure.ResourceManager.DataLakeStore/) | -| Resource Management - Data Migration | NuGet [1.0.0-beta.6](https://www.nuget.org/packages/Azure.ResourceManager.DataMigration/1.0.0-beta.6) | [docs](/dotnet/api/overview/azure/ResourceManager.DataMigration-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.6](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataMigration_1.0.0-beta.6/sdk/datamigration/Azure.ResourceManager.DataMigration/) | +| Resource Management - Data Migration | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.DataMigration/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DataMigration-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataMigration_1.0.0/sdk/datamigration/Azure.ResourceManager.DataMigration/) | | Resource Management - Data Protection | NuGet [1.7.0](https://www.nuget.org/packages/Azure.ResourceManager.DataProtectionBackup/1.7.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DataProtectionBackup-readme) | GitHub [1.7.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataProtectionBackup_1.7.0/sdk/dataprotection/Azure.ResourceManager.DataProtectionBackup/) | | Resource Management - Data Share | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DataShare/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DataShare-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataShare_1.1.1/sdk/datashare/Azure.ResourceManager.DataShare/) | | Resource Management - Database Fleet Manager | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DatabaseFleetManager/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DatabaseFleetManager-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DatabaseFleetManager_1.0.0-beta.1/sdk/fleet/Azure.ResourceManager.DatabaseFleetManager/) | @@ -245,6 +245,7 @@ | Resource Management - DevOps Infrastructure | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DevOpsInfrastructure/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DevOpsInfrastructure-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DevOpsInfrastructure_1.0.0-beta.1/sdk/devopsinfrastructure/Azure.ResourceManager.DevOpsInfrastructure/) | | Resource Management - DevTest Labs | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DevTestLabs/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DevTestLabs-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DevTestLabs_1.1.1/sdk/devtestlabs/Azure.ResourceManager.DevTestLabs/) | | Resource Management - Digital Twins | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.DigitalTwins/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DigitalTwins-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DigitalTwins_1.3.1/sdk/digitaltwins/Azure.ResourceManager.DigitalTwins/) | +| Resource Management - Disconnectedoperations | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DisconnectedOperations/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DisconnectedOperations-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DisconnectedOperations_1.0.0-beta.1/sdk/disconnectedoperations/Azure.ResourceManager.DisconnectedOperations/) | | Resource Management - DNS | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Dns/1.1.1)
NuGet [1.2.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Dns/1.2.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Dns-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dns_1.1.1/sdk/dns/Azure.ResourceManager.Dns/)
GitHub [1.2.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dns_1.2.0-beta.2/sdk/dns/Azure.ResourceManager.Dns/) | | Resource Management - DNS Resolver | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.DnsResolver/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DnsResolver-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DnsResolver_1.2.0/sdk/dnsresolver/Azure.ResourceManager.DnsResolver/) | | Resource Management - Durabletask | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DurableTask/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DurableTask-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DurableTask_1.0.0-beta.1/sdk/durabletask/Azure.ResourceManager.DurableTask/) | @@ -404,7 +405,7 @@ | HTTP ASPNETCore Analyzers | NuGet [1.0.4](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Http.AspNetCore.Analyzers/1.0.4) | | | | IoT Operations MQTT | NuGet [0.11.0](https://www.nuget.org/packages/Azure.Iot.Operations.Mqtt/0.11.0) | | | | IoT Operations Protocol | NuGet [0.12.1](https://www.nuget.org/packages/Azure.Iot.Operations.Protocol/0.12.1) | | | -| IoT Operations Services | NuGet [0.14.0](https://www.nuget.org/packages/Azure.Iot.Operations.Services/0.14.0) | | | +| IoT Operations Services | NuGet [0.15.0-preview](https://www.nuget.org/packages/Azure.Iot.Operations.Services/0.15.0-preview) | | | | Item Templates NetCore | NuGet [4.0.5267](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.ItemTemplates.NetCore/4.0.5267) | | | | Item Templates NetFx | NuGet [4.0.5267](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.ItemTemplates.NetFx/4.0.5267) | | | | Microsoft.Azure.DataFactoryTestingFramework.Expressions | NuGet [0.2.7](https://www.nuget.org/packages/Microsoft.Azure.DataFactoryTestingFramework.Expressions/0.2.7) | | | @@ -416,14 +417,14 @@ | Speech Extension ONNX Runtime | NuGet [1.46.0](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech.Extension.ONNX.Runtime/1.46.0) | | | | Speech Extension Telemetry | NuGet [1.46.0](https://www.nuget.org/packages/Microsoft.CognitiveServices.Speech.Extension.Telemetry/1.46.0) | | | | System Net Client Model | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/System.Net.ClientModel/1.0.0-beta.1) | | | -| Unknown Display Name | NuGet [0.12.0](https://www.nuget.org/packages/Azure.Iot.Operations.Connector/0.12.0) | | | -| Unknown Display Name | NuGet [0.8.1](https://www.nuget.org/packages/Azure.Mcp/0.8.1) | | | -| Unknown Display Name | NuGet [0.8.1](https://www.nuget.org/packages/Azure.Mcp.linux-arm64/0.8.1) | | | -| Unknown Display Name | NuGet [0.8.1](https://www.nuget.org/packages/Azure.Mcp.linux-x64/0.8.1) | | | -| Unknown Display Name | NuGet [0.8.1](https://www.nuget.org/packages/Azure.Mcp.osx-arm64/0.8.1) | | | -| Unknown Display Name | NuGet [0.8.1](https://www.nuget.org/packages/Azure.Mcp.osx-x64/0.8.1) | | | -| Unknown Display Name | NuGet [0.8.1](https://www.nuget.org/packages/Azure.Mcp.win-arm64/0.8.1) | | | -| Unknown Display Name | NuGet [0.8.1](https://www.nuget.org/packages/Azure.Mcp.win-x64/0.8.1) | | | +| Unknown Display Name | NuGet [0.13.0-preview](https://www.nuget.org/packages/Azure.Iot.Operations.Connector/0.13.0-preview) | | | +| Unknown Display Name | NuGet [0.8.2](https://www.nuget.org/packages/Azure.Mcp/0.8.2) | | | +| Unknown Display Name | NuGet [0.8.2](https://www.nuget.org/packages/Azure.Mcp.linux-arm64/0.8.2) | | | +| Unknown Display Name | NuGet [0.8.2](https://www.nuget.org/packages/Azure.Mcp.linux-x64/0.8.2) | | | +| Unknown Display Name | NuGet [0.8.2](https://www.nuget.org/packages/Azure.Mcp.osx-arm64/0.8.2) | | | +| Unknown Display Name | NuGet [0.8.2](https://www.nuget.org/packages/Azure.Mcp.osx-x64/0.8.2) | | | +| Unknown Display Name | NuGet [0.8.2](https://www.nuget.org/packages/Azure.Mcp.win-arm64/0.8.2) | | | +| Unknown Display Name | NuGet [0.8.2](https://www.nuget.org/packages/Azure.Mcp.win-x64/0.8.2) | | | | Unknown Display Name | NuGet [0.1.2-preview.2](https://www.nuget.org/packages/Microsoft.Azure.Cosmos.Aot/0.1.2-preview.2) | | | | Unknown Display Name | NuGet [0.2.802](https://www.nuget.org/packages/Microsoft.Azure.Mcp.AzTypes.Internal.Compact/0.2.802) | | | | Unknown Display Name | NuGet [1.1.2-preview](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.AzureCosmosDb.Mongo/1.1.2-preview) | | | @@ -579,7 +580,7 @@ | Microsoft.Azure.Functions.Worker.Extensions.RabbitMQ | NuGet [2.1.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.RabbitMQ/2.1.0) | | | | Microsoft.Azure.Functions.Worker.Extensions.Rpc | NuGet [1.0.1](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Rpc/1.0.1) | | | | Microsoft.Azure.Functions.Worker.Extensions.SendGrid | NuGet [3.1.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.SendGrid/3.1.0) | | | -| Microsoft.Azure.Functions.Worker.Extensions.ServiceBus | NuGet [5.23.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.ServiceBus/5.23.0) | | | +| Microsoft.Azure.Functions.Worker.Extensions.ServiceBus | NuGet [5.24.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.ServiceBus/5.24.0) | | | | Microsoft.Azure.Functions.Worker.Extensions.SignalRService | NuGet [2.0.1](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.SignalRService/2.0.1) | | | | Microsoft.Azure.Functions.Worker.Extensions.Sql | NuGet [3.1.527](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Sql/3.1.527) | | | | Microsoft.Azure.Functions.Worker.Extensions.Storage | NuGet [6.8.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.Storage/6.8.0) | | | diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md index 18f7b6ad78942..a7a5f835290a8 100644 --- a/docs/azure/includes/dotnet-new.md +++ b/docs/azure/includes/dotnet-new.md @@ -51,7 +51,7 @@ | FarmBeats | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.Verticals.AgriFood.Farming/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/Verticals.AgriFood.Farming-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Verticals.AgriFood.Farming_1.0.0-beta.2/sdk/agrifood/Azure.Verticals.AgriFood.Farming/) | | Form Recognizer | NuGet [4.1.0](https://www.nuget.org/packages/Azure.AI.FormRecognizer/4.1.0) | [docs](/dotnet/api/overview/azure/AI.FormRecognizer-readme) | GitHub [4.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.FormRecognizer_4.1.0/sdk/formrecognizer/Azure.AI.FormRecognizer/) | | Functions Extensions - WebPubSub | NuGet [1.7.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.WebPubSub/1.7.0) | [docs](/dotnet/api/overview/azure/Microsoft.Azure.Functions.Worker.Extensions.WebPubSub-readme) | GitHub [1.7.0](https://github.com/Azure/azure-sdk-for-net/tree/Microsoft.Azure.Functions.Worker.Extensions.WebPubSub_1.7.0/sdk/webpubsub/Microsoft.Azure.Functions.Worker.Extensions.WebPubSub/) | -| Health Deidentification | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Health.Deidentification/1.0.0) | [docs](/dotnet/api/overview/azure/Health.Deidentification-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Deidentification_1.0.0/sdk/healthdataaiservices/Azure.Health.Deidentification/) | +| Health Deidentification | NuGet [1.0.0](https://www.nuget.org/packages/Azure.Health.Deidentification/1.0.0)
NuGet [1.1.0-beta.1](https://www.nuget.org/packages/Azure.Health.Deidentification/1.1.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Deidentification-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Deidentification_1.0.0/sdk/healthdataaiservices/Azure.Health.Deidentification/)
GitHub [1.1.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Deidentification_1.1.0-beta.1/sdk/healthdataaiservices/Azure.Health.Deidentification/) | | Health Insights Cancer Profiling | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Health.Insights.CancerProfiling/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Insights.CancerProfiling-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.CancerProfiling_1.0.0-beta.1/sdk/healthinsights/Azure.Health.Insights.CancerProfiling/) | | Health Insights Clinical Matching | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Health.Insights.ClinicalMatching/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Health.Insights.ClinicalMatching-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.ClinicalMatching_1.0.0-beta.1/sdk/healthinsights/Azure.Health.Insights.ClinicalMatching/) | | Health Insights Radiology Insights | NuGet [1.1.0](https://www.nuget.org/packages/Azure.Health.Insights.RadiologyInsights/1.1.0) | [docs](/dotnet/api/overview/azure/Health.Insights.RadiologyInsights-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Health.Insights.RadiologyInsights_1.1.0/sdk/healthinsights/Azure.Health.Insights.RadiologyInsights/) | @@ -123,7 +123,7 @@ | Text Translation | NuGet [1.0.0](https://www.nuget.org/packages/Azure.AI.Translation.Text/1.0.0) | [docs](/dotnet/api/overview/azure/AI.Translation.Text-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.Translation.Text_1.0.0/sdk/translation/Azure.AI.Translation.Text/) | | Time Series Insights | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.IoT.TimeSeriesInsights/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/IoT.TimeSeriesInsights-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.IoT.TimeSeriesInsights_1.0.0-beta.1/sdk/timeseriesinsights/Azure.IoT.TimeSeriesInsights/) | | TimeZone | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Maps.TimeZones/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Maps.TimeZones-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Maps.TimeZones_1.0.0-beta.1/sdk/maps/Azure.Maps.TimeZones/) | -| unknown | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.AI.VoiceLive/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/AI.VoiceLive-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.VoiceLive_1.0.0-beta.2/sdk/ai/Azure.AI.VoiceLive/) | +| unknown | NuGet [1.0.0-beta.3](https://www.nuget.org/packages/Azure.AI.VoiceLive/1.0.0-beta.3) | [docs](/dotnet/api/overview/azure/AI.VoiceLive-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.AI.VoiceLive_1.0.0-beta.3/sdk/ai/Azure.AI.VoiceLive/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Analytics.OnlineExperimentation/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Analytics.OnlineExperimentation-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Analytics.OnlineExperimentation_1.0.0-beta.1/sdk/onlineexperimentation/Azure.Analytics.OnlineExperimentation/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Projects/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Projects-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Projects_1.0.0-beta.1/sdk/cloudmachine/Azure.Projects/) | | unknown | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.Projects.AI/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/Projects.AI-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.Projects.AI_1.0.0-beta.1/sdk/cloudmachine/Azure.Projects.AI/) | @@ -236,7 +236,7 @@ | Resource Management - Data Factory | NuGet [1.9.0](https://www.nuget.org/packages/Azure.ResourceManager.DataFactory/1.9.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DataFactory-readme) | GitHub [1.9.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataFactory_1.9.0/sdk/datafactory/Azure.ResourceManager.DataFactory/) | | Resource Management - Data Lake Analytics | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DataLakeAnalytics/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DataLakeAnalytics-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataLakeAnalytics_1.1.1/sdk/datalake-analytics/Azure.ResourceManager.DataLakeAnalytics/) | | Resource Management - Data Lake Store | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DataLakeStore/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DataLakeStore-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataLakeStore_1.1.1/sdk/datalake-store/Azure.ResourceManager.DataLakeStore/) | -| Resource Management - Data Migration | NuGet [1.0.0-beta.6](https://www.nuget.org/packages/Azure.ResourceManager.DataMigration/1.0.0-beta.6) | [docs](/dotnet/api/overview/azure/ResourceManager.DataMigration-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.6](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataMigration_1.0.0-beta.6/sdk/datamigration/Azure.ResourceManager.DataMigration/) | +| Resource Management - Data Migration | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.DataMigration/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DataMigration-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataMigration_1.0.0/sdk/datamigration/Azure.ResourceManager.DataMigration/) | | Resource Management - Data Protection | NuGet [1.7.0](https://www.nuget.org/packages/Azure.ResourceManager.DataProtectionBackup/1.7.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DataProtectionBackup-readme) | GitHub [1.7.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataProtectionBackup_1.7.0/sdk/dataprotection/Azure.ResourceManager.DataProtectionBackup/) | | Resource Management - Data Share | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DataShare/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DataShare-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DataShare_1.1.1/sdk/datashare/Azure.ResourceManager.DataShare/) | | Resource Management - Database Fleet Manager | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DatabaseFleetManager/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DatabaseFleetManager-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DatabaseFleetManager_1.0.0-beta.1/sdk/fleet/Azure.ResourceManager.DatabaseFleetManager/) | @@ -255,6 +255,7 @@ | Resource Management - DevOps Infrastructure | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DevOpsInfrastructure/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DevOpsInfrastructure-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DevOpsInfrastructure_1.0.0-beta.1/sdk/devopsinfrastructure/Azure.ResourceManager.DevOpsInfrastructure/) | | Resource Management - DevTest Labs | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.DevTestLabs/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DevTestLabs-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DevTestLabs_1.1.1/sdk/devtestlabs/Azure.ResourceManager.DevTestLabs/) | | Resource Management - Digital Twins | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.DigitalTwins/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DigitalTwins-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DigitalTwins_1.3.1/sdk/digitaltwins/Azure.ResourceManager.DigitalTwins/) | +| Resource Management - Disconnectedoperations | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DisconnectedOperations/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DisconnectedOperations-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DisconnectedOperations_1.0.0-beta.1/sdk/disconnectedoperations/Azure.ResourceManager.DisconnectedOperations/) | | Resource Management - DNS | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.Dns/1.1.1)
NuGet [1.2.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.Dns/1.2.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.Dns-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dns_1.1.1/sdk/dns/Azure.ResourceManager.Dns/)
GitHub [1.2.0-beta.2](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Dns_1.2.0-beta.2/sdk/dns/Azure.ResourceManager.Dns/) | | Resource Management - DNS Resolver | NuGet [1.2.0](https://www.nuget.org/packages/Azure.ResourceManager.DnsResolver/1.2.0) | [docs](/dotnet/api/overview/azure/ResourceManager.DnsResolver-readme) | GitHub [1.2.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DnsResolver_1.2.0/sdk/dnsresolver/Azure.ResourceManager.DnsResolver/) | | Resource Management - Durabletask | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.DurableTask/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.DurableTask-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.DurableTask_1.0.0-beta.1/sdk/durabletask/Azure.ResourceManager.DurableTask/) | From 9022b0d8b3370e0f20a733c150c8d8d23b88b67f Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Mon, 29 Sep 2025 09:50:35 -0400 Subject: [PATCH 3/9] Add formatting guidelines for F# reverse pipeline operator (#48742) * Initial plan * Add guidance for reverse pipeline operator formatting Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com> * Update docs/fsharp/style-guide/formatting.md * Update reverse pipeline examples to align with Fantomas formatting conventions Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: BillWagner <493969+BillWagner@users.noreply.github.com> Co-authored-by: Bill Wagner --- docs/fsharp/style-guide/formatting.md | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/docs/fsharp/style-guide/formatting.md b/docs/fsharp/style-guide/formatting.md index 40646fdd7c289..fb7fc61872bd9 100644 --- a/docs/fsharp/style-guide/formatting.md +++ b/docs/fsharp/style-guide/formatting.md @@ -395,6 +395,30 @@ let methods2 = System.AppDomain.CurrentDomain.GetAssemblies() |> Array.concat ``` +For reverse pipeline `<|` operators, keep short expressions on a single line. When line length requires wrapping, place arguments on new lines and align them consistently: + +```fsharp +// ✔️ OK - short expressions stay on one line +let result = someFunction <| arg1 <| arg2 <| arg3 + +// ✔️ OK - longer expressions can wrap when necessary +failwith +<| sprintf "A very long error message that exceeds reasonable line length: %s - additional details: %s" + longVariableName + anotherLongVariableName + +// ✔️ OK - align continuation lines with the operator +let longResult = + someVeryLongFunctionName + <| firstVeryLongArgumentName + <| secondVeryLongArgumentName + <| thirdVeryLongArgumentName + +// ❌ Not OK - unnecessary wrapping of short expressions +failwith <| sprintf "short: %s" + value +``` + ### Formatting lambda expressions When a lambda expression is used as an argument in a multi-line expression, and is followed by other arguments, @@ -571,6 +595,7 @@ The following operators are defined in the F# standard library and should be use ```fsharp // ✔️ OK x |> f // Forward pipeline +f <| x // Reverse pipeline f >> g // Forward composition x |> ignore // Discard away a value x + y // Overloaded addition (including string concatenation) From 3668570ad8af31edb29d94cf6052569296bc8c72 Mon Sep 17 00:00:00 2001 From: Azure SDK Bot <53356347+azure-sdk@users.noreply.github.com> Date: Mon, 29 Sep 2025 10:30:18 -0700 Subject: [PATCH 4/9] Update package index with latest published versions (#48771) --- docs/azure/includes/dotnet-all.md | 6 +++--- docs/azure/includes/dotnet-new.md | 4 ++-- 2 files changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/azure/includes/dotnet-all.md b/docs/azure/includes/dotnet-all.md index 0f8e65b99175a..aefc71739e4a1 100644 --- a/docs/azure/includes/dotnet-all.md +++ b/docs/azure/includes/dotnet-all.md @@ -211,7 +211,7 @@ | Resource Management - Connectedcache | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ConnectedCache/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ConnectedCache-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConnectedCache_1.0.0-beta.1/sdk/connectedcache/Azure.ResourceManager.ConnectedCache/) | | Resource Management - Consumption | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Consumption/1.0.1)
NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.Consumption/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.Consumption-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Consumption_1.0.1/sdk/consumption/Azure.ResourceManager.Consumption/)
GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Consumption_1.1.0-beta.3/sdk/consumption/Azure.ResourceManager.Consumption/) | | Resource Management - Container Apps | NuGet [1.4.1](https://www.nuget.org/packages/Azure.ResourceManager.AppContainers/1.4.1) | [docs](/dotnet/api/overview/azure/ResourceManager.AppContainers-readme) | GitHub [1.4.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.AppContainers_1.4.1/sdk/containerapps/Azure.ResourceManager.AppContainers/) | -| Resource Management - Container Instances | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerInstance/1.2.1)
NuGet [1.3.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.ContainerInstance/1.3.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerInstance-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerInstance_1.2.1/sdk/containerinstance/Azure.ResourceManager.ContainerInstance/)
GitHub [1.3.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerInstance_1.3.0-beta.4/sdk/containerinstance/Azure.ResourceManager.ContainerInstance/) | +| Resource Management - Container Instances | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.ContainerInstance/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerInstance-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerInstance_1.3.0/sdk/containerinstance/Azure.ResourceManager.ContainerInstance/) | | Resource Management - Container Orchestrator Runtime | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerOrchestratorRuntime/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerOrchestratorRuntime-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerOrchestratorRuntime_1.0.0-beta.1/sdk/containerorchestratorruntime/Azure.ResourceManager.ContainerOrchestratorRuntime/) | | Resource Management - Container Registry | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerRegistry/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerRegistry-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerRegistry_1.3.1/sdk/containerregistry/Azure.ResourceManager.ContainerRegistry/) | | Resource Management - Container Service | NuGet [1.2.5](https://www.nuget.org/packages/Azure.ResourceManager.ContainerService/1.2.5) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerService-readme) | GitHub [1.2.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerService_1.2.5/sdk/containerservice/Azure.ResourceManager.ContainerService/) | @@ -363,7 +363,7 @@ | Resource Management - Service Linker | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceLinker/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceLinker-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceLinker_1.1.1/sdk/servicelinker/Azure.ResourceManager.ServiceLinker/) | | Resource Management - Service Networking | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ServiceNetworking/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceNetworking-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.1.0/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/) | | Resource Management - SignalR | NuGet [1.1.4](https://www.nuget.org/packages/Azure.ResourceManager.SignalR/1.1.4) | [docs](/dotnet/api/overview/azure/ResourceManager.SignalR-readme) | GitHub [1.1.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SignalR_1.1.4/sdk/signalr/Azure.ResourceManager.SignalR/) | -| Resource Management - Sitemanager | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.SiteManager/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.SiteManager-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SiteManager_1.0.0-beta.1/sdk/sitemanager/Azure.ResourceManager.SiteManager/) | +| Resource Management - Sitemanager | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.SiteManager/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.SiteManager-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SiteManager_1.0.0/sdk/sitemanager/Azure.ResourceManager.SiteManager/) | | Resource Management - Sphere | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Sphere/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Sphere-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sphere_1.0.1/sdk/sphere/Azure.ResourceManager.Sphere/) | | Resource Management - Spring App Discovery | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.SpringAppDiscovery/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.SpringAppDiscovery-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.SpringAppDiscovery_1.0.0-beta.2/sdk/springappdiscovery/Azure.ResourceManager.SpringAppDiscovery/) | | Resource Management - SQL | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Sql/1.3.0)
NuGet [1.4.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.Sql/1.4.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.Sql-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sql_1.3.0/sdk/sqlmanagement/Azure.ResourceManager.Sql/)
GitHub [1.4.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sql_1.4.0-beta.3/sdk/sqlmanagement/Azure.ResourceManager.Sql/) | @@ -538,7 +538,7 @@ | Functions extension for Durable Task Framework - isolated worker | NuGet [1.8.0](https://www.nuget.org/packages/Microsoft.Azure.Functions.Worker.Extensions.DurableTask/1.8.0) | | | | 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.1.3](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Kafka/4.1.3) | | GitHub [4.1.3](https://github.com/Azure/azure-functions-kafka-extension/tree/3.0.0/src/Microsoft.Azure.WebJobs.Extensions.Kafka) | +| Functions extension for Kafka | NuGet [4.1.4](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.Kafka/4.1.4) | | GitHub [4.1.4](https://github.com/Azure/azure-functions-kafka-extension/tree/3.0.0/src/Microsoft.Azure.WebJobs.Extensions.Kafka) | | Functions extension for Notification Hubs | NuGet [1.3.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.NotificationHubs/1.3.0) | | GitHub [1.3.0](https://github.com/Azure/azure-webjobs-sdk-extensions) | | Functions extension for RabbitMQ | NuGet [2.1.0](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Extensions.RabbitMQ/2.1.0) | | GitHub [2.1.0](https://github.com/Azure/azure-functions-rabbitmq-extension/tree/v0.2.2029-beta) | | Functions extension for script abstractions | NuGet [1.0.4-preview](https://www.nuget.org/packages/Microsoft.Azure.WebJobs.Script.Abstractions/1.0.4-preview) | | | diff --git a/docs/azure/includes/dotnet-new.md b/docs/azure/includes/dotnet-new.md index a7a5f835290a8..323c5032cbf6c 100644 --- a/docs/azure/includes/dotnet-new.md +++ b/docs/azure/includes/dotnet-new.md @@ -221,7 +221,7 @@ | Resource Management - Connectedcache | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ConnectedCache/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ConnectedCache-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ConnectedCache_1.0.0-beta.1/sdk/connectedcache/Azure.ResourceManager.ConnectedCache/) | | Resource Management - Consumption | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Consumption/1.0.1)
NuGet [1.1.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.Consumption/1.1.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.Consumption-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Consumption_1.0.1/sdk/consumption/Azure.ResourceManager.Consumption/)
GitHub [1.1.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Consumption_1.1.0-beta.3/sdk/consumption/Azure.ResourceManager.Consumption/) | | Resource Management - Container Apps | NuGet [1.4.1](https://www.nuget.org/packages/Azure.ResourceManager.AppContainers/1.4.1) | [docs](/dotnet/api/overview/azure/ResourceManager.AppContainers-readme) | GitHub [1.4.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.AppContainers_1.4.1/sdk/containerapps/Azure.ResourceManager.AppContainers/) | -| Resource Management - Container Instances | NuGet [1.2.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerInstance/1.2.1)
NuGet [1.3.0-beta.4](https://www.nuget.org/packages/Azure.ResourceManager.ContainerInstance/1.3.0-beta.4) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerInstance-readme) | GitHub [1.2.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerInstance_1.2.1/sdk/containerinstance/Azure.ResourceManager.ContainerInstance/)
GitHub [1.3.0-beta.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerInstance_1.3.0-beta.4/sdk/containerinstance/Azure.ResourceManager.ContainerInstance/) | +| Resource Management - Container Instances | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.ContainerInstance/1.3.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerInstance-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerInstance_1.3.0/sdk/containerinstance/Azure.ResourceManager.ContainerInstance/) | | Resource Management - Container Orchestrator Runtime | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerOrchestratorRuntime/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerOrchestratorRuntime-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerOrchestratorRuntime_1.0.0-beta.1/sdk/containerorchestratorruntime/Azure.ResourceManager.ContainerOrchestratorRuntime/) | | Resource Management - Container Registry | NuGet [1.3.1](https://www.nuget.org/packages/Azure.ResourceManager.ContainerRegistry/1.3.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerRegistry-readme) | GitHub [1.3.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerRegistry_1.3.1/sdk/containerregistry/Azure.ResourceManager.ContainerRegistry/) | | Resource Management - Container Service | NuGet [1.2.5](https://www.nuget.org/packages/Azure.ResourceManager.ContainerService/1.2.5) | [docs](/dotnet/api/overview/azure/ResourceManager.ContainerService-readme) | GitHub [1.2.5](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ContainerService_1.2.5/sdk/containerservice/Azure.ResourceManager.ContainerService/) | @@ -377,7 +377,7 @@ | Resource Management - Service Linker | NuGet [1.1.1](https://www.nuget.org/packages/Azure.ResourceManager.ServiceLinker/1.1.1) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceLinker-readme) | GitHub [1.1.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceLinker_1.1.1/sdk/servicelinker/Azure.ResourceManager.ServiceLinker/) | | Resource Management - Service Networking | NuGet [1.1.0](https://www.nuget.org/packages/Azure.ResourceManager.ServiceNetworking/1.1.0) | [docs](/dotnet/api/overview/azure/ResourceManager.ServiceNetworking-readme) | GitHub [1.1.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.ServiceNetworking_1.1.0/sdk/servicenetworking/Azure.ResourceManager.ServiceNetworking/) | | Resource Management - SignalR | NuGet [1.1.4](https://www.nuget.org/packages/Azure.ResourceManager.SignalR/1.1.4) | [docs](/dotnet/api/overview/azure/ResourceManager.SignalR-readme) | GitHub [1.1.4](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SignalR_1.1.4/sdk/signalr/Azure.ResourceManager.SignalR/) | -| Resource Management - Sitemanager | NuGet [1.0.0-beta.1](https://www.nuget.org/packages/Azure.ResourceManager.SiteManager/1.0.0-beta.1) | [docs](/dotnet/api/overview/azure/ResourceManager.SiteManager-readme?view=azure-dotnet-preview&preserve-view=true) | GitHub [1.0.0-beta.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SiteManager_1.0.0-beta.1/sdk/sitemanager/Azure.ResourceManager.SiteManager/) | +| Resource Management - Sitemanager | NuGet [1.0.0](https://www.nuget.org/packages/Azure.ResourceManager.SiteManager/1.0.0) | [docs](/dotnet/api/overview/azure/ResourceManager.SiteManager-readme) | GitHub [1.0.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.SiteManager_1.0.0/sdk/sitemanager/Azure.ResourceManager.SiteManager/) | | Resource Management - Sphere | NuGet [1.0.1](https://www.nuget.org/packages/Azure.ResourceManager.Sphere/1.0.1) | [docs](/dotnet/api/overview/azure/ResourceManager.Sphere-readme) | GitHub [1.0.1](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sphere_1.0.1/sdk/sphere/Azure.ResourceManager.Sphere/) | | Resource Management - Spring App Discovery | NuGet [1.0.0-beta.2](https://www.nuget.org/packages/Azure.ResourceManager.SpringAppDiscovery/1.0.0-beta.2) | [docs](/dotnet/api/overview/azure/ResourceManager.SpringAppDiscovery-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.SpringAppDiscovery_1.0.0-beta.2/sdk/springappdiscovery/Azure.ResourceManager.SpringAppDiscovery/) | | Resource Management - SQL | NuGet [1.3.0](https://www.nuget.org/packages/Azure.ResourceManager.Sql/1.3.0)
NuGet [1.4.0-beta.3](https://www.nuget.org/packages/Azure.ResourceManager.Sql/1.4.0-beta.3) | [docs](/dotnet/api/overview/azure/ResourceManager.Sql-readme) | GitHub [1.3.0](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sql_1.3.0/sdk/sqlmanagement/Azure.ResourceManager.Sql/)
GitHub [1.4.0-beta.3](https://github.com/Azure/azure-sdk-for-net/tree/Azure.ResourceManager.Sql_1.4.0-beta.3/sdk/sqlmanagement/Azure.ResourceManager.Sql/) | From 26023b225e00db14d4aef75ab8e189be8dff5573 Mon Sep 17 00:00:00 2001 From: "Meaghan Osagie (Lewis)" Date: Mon, 29 Sep 2025 17:43:52 +0000 Subject: [PATCH 5/9] Link to the versionless ASP.NET migration article (#48773) * Link to the versionless ASP.NET migration article * Remove extra lines in file --- docs/core/install/upgrade.md | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/core/install/upgrade.md b/docs/core/install/upgrade.md index ca1b1ffb2845d..2bd94c9918ee8 100644 --- a/docs/core/install/upgrade.md +++ b/docs/core/install/upgrade.md @@ -34,9 +34,9 @@ The only required change to upgrade an app is updating the `TargetFramework` pro Here's how to do it: -* Open the project file (the `*.csproj`, `*.vbproj`, or `*.fsproj` file). -* Change the `` property value from, for example, `net6.0` to `net8.0`. -* The same pattern applies for the `` property if it is being used. +- Open the project file (the `*.csproj`, `*.vbproj`, or `*.fsproj` file). +- Change the `` property value from, for example, `net6.0` to `net8.0`. +- The same pattern applies for the `` property if it is being used. > [!TIP] > The [GitHub Copilot app modernization - upgrade](../porting/github-copilot-app-modernization-overview.md) capability can make these changes automatically. @@ -47,9 +47,9 @@ You might need to run `dotnet workload restore` to restore workloads with the ne More resources: -* [Breaking changes in .NET 9](../compatibility/9.0.md) -* [Migrate from ASP.NET Core in .NET 7 to .NET 8](/aspnet/core/migration/70-80?tabs=visual-studio) -* [Upgrade .NET MAUI from .NET 7 to .NET 8](https://github.com/dotnet/maui/wiki/Upgrading-.NET-MAUI-from-.NET-7-to-.NET-8) +- [Breaking changes in .NET 9](../compatibility/9.0.md) +- [Migrate an ASP.NET Core app](/aspnet/core/migration/) +- [Upgrade .NET MAUI from .NET 7 to .NET 8](https://github.com/dotnet/maui/wiki/Upgrading-.NET-MAUI-from-.NET-7-to-.NET-8) ## Update continuous integration (CI) From 86c5a92a45aacbdce0afe6f9bad8abe806db5ff7 Mon Sep 17 00:00:00 2001 From: Copilot <198982749+Copilot@users.noreply.github.com> Date: Mon, 29 Sep 2025 11:18:08 -0700 Subject: [PATCH 6/9] Capitalize Terminal Logger as proper noun in .NET CLI documentation (#48772) * Initial plan * Capitalize Terminal Logger as proper noun in documentation Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com> * Remove the preface from Terminal Logger * Update docs/core/whats-new/dotnet-9/sdk.md Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --------- Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: meaghanlewis <10103121+meaghanlewis@users.noreply.github.com> Co-authored-by: Meaghan Osagie Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com> --- docs/core/compatibility/9.0.md | 2 +- .../compatibility/sdk/9.0/terminal-logger.md | 20 ++++++++-------- docs/core/whats-new/dotnet-8/sdk.md | 2 +- docs/core/whats-new/dotnet-9/overview.md | 2 +- docs/core/whats-new/dotnet-9/sdk.md | 24 +++++++++---------- includes/cli-tl.md | 4 ++-- 6 files changed, 27 insertions(+), 27 deletions(-) diff --git a/docs/core/compatibility/9.0.md b/docs/core/compatibility/9.0.md index aee1b828ef5af..03efb5bd505d6 100644 --- a/docs/core/compatibility/9.0.md +++ b/docs/core/compatibility/9.0.md @@ -108,7 +108,7 @@ If you're migrating an app to .NET 9, the breaking changes listed here might aff | [`installer` repo version no longer documented](sdk/9.0/productcommits-versions.md) | Behavioral change | Preview 5 | | [MSBuild custom culture resource handling](sdk/10.0/msbuild-custom-culture.md) | Behavioral change | 9.0.200/9.0.300 | | [New default RID used when targeting .NET Framework](sdk/9.0/default-rid.md) | Source incompatible | GA | -| [Terminal logger is default](sdk/9.0/terminal-logger.md) | Behavioral change | Preview 1 | +| [Terminal Logger is default](sdk/9.0/terminal-logger.md) | Behavioral change | Preview 1 | | [Version requirements for .NET 9 SDK](sdk/9.0/version-requirements.md) | Source incompatible | GA | | [Warning emitted for .NET Standard 1.x target](sdk/9.0/netstandard-warning.md) | Source incompatible | Preview 6 | | [Warning emitted for .NET 7 target](sdk/9.0/net70-warning.md) | Source incompatible | GA | diff --git a/docs/core/compatibility/sdk/9.0/terminal-logger.md b/docs/core/compatibility/sdk/9.0/terminal-logger.md index fd01429a6a48a..deacdad053edf 100644 --- a/docs/core/compatibility/sdk/9.0/terminal-logger.md +++ b/docs/core/compatibility/sdk/9.0/terminal-logger.md @@ -1,11 +1,11 @@ --- -title: "Breaking change: Terminal logger is default" -description: Learn about a breaking change in the .NET 9 SDK where the terminal logger is used by default for interactive MSBuild invocations. +title: "Breaking change: Terminal Logger is default" +description: Learn about a breaking change in the .NET 9 SDK where Terminal Logger is used by default for interactive MSBuild invocations. ms.date: 01/10/2024 --- -# Terminal logger is default +# Terminal Logger is default -The terminal logger is now enabled by default for all "interactive" terminal sessions. The terminal logger formats the console output for builds differently to the console logger. For more information about the terminal logger, see ['dotnet build' options](../../../tools/dotnet-build.md#options), specifically the `--tl` option. +Terminal Logger is now enabled by default for all "interactive" terminal sessions. Terminal Logger formats the console output for builds differently to the console logger. For more information about Terminal Logger, see ['dotnet build' options](../../../tools/dotnet-build.md#options), specifically the `--tl` option. ## Previous behavior @@ -13,7 +13,7 @@ The terminal logger is now enabled by default for all "interactive" terminal ses ## New behavior -If the terminal supports various layout and colorization features, `dotnet build` and other build-related CLI commands use the terminal logger by default for user-triggered builds. If the command is part of a shell script or has had input or output redirected in any way, or if the terminal doesn't support some of the enhanced layout features that terminal logger has, then the terminal logger isn't used. +If the terminal supports various layout and colorization features, `dotnet build` and other build-related CLI commands use Terminal Logger by default for user-triggered builds. If the command is part of a shell script or has had input or output redirected in any way, or if the terminal doesn't support some of the enhanced layout features that Terminal Logger has, then Terminal Logger isn't used. ## Version introduced @@ -25,14 +25,14 @@ This change is a [behavioral change](../../categories.md#behavioral-change). ## Reason for change -The terminal logger output about the progress of a build is more information dense and actionable than the console logger output. The MSBuild team wants to encourage the use of terminal logger early in the .NET 9 release cycle so that there's time to gather feedback about the quality and functionality of the feature. +Terminal Logger output about the progress of a build is more information dense and actionable than the console logger output. The MSBuild team wants to encourage the use of Terminal Logger early in the .NET 9 release cycle so that there's time to gather feedback about the quality and functionality of the feature. ## Recommended action -If you need to revert to the console logger, you can disable the terminal logger can be disabled in the following ways: +If you need to revert to the console logger, you can disable Terminal Logger in the following ways: -- To disable terminal logger for a specific command, specify `--tl:off` on the command line or via an MSBuild response file. -- To disable terminal logger for all commands, set the `MSBUILDTERMINALLOGGER` environment variable to `off`. +- To disable Terminal Logger for a specific command, specify `--tl:off` on the command line or via an MSBuild response file. +- To disable Terminal Logger for all commands, set the `MSBUILDTERMINALLOGGER` environment variable to `off`. ## Affected APIs @@ -41,4 +41,4 @@ N/A ## See also - ['dotnet build' options](../../../tools/dotnet-build.md#options) -- [Terminal logger](../../../whats-new/dotnet-9/sdk.md#terminal-logger) +- [Terminal Logger](../../../whats-new/dotnet-9/sdk.md#terminal-logger) diff --git a/docs/core/whats-new/dotnet-8/sdk.md b/docs/core/whats-new/dotnet-8/sdk.md index 2a5b84523cc97..9f5bb2dc0dd42 100644 --- a/docs/core/whats-new/dotnet-8/sdk.md +++ b/docs/core/whats-new/dotnet-8/sdk.md @@ -66,7 +66,7 @@ bin\Release\net8.0\ ### Terminal build output -`dotnet build` has a new option to produce more modernized build output. This *terminal logger* output groups errors with the project they came from, better differentiates the different target frameworks for multi-targeted projects, and provides real-time information about what the build is doing. To opt in to the new output, use the `--tl` option. For more information about this option, see [dotnet build options](../../tools/dotnet-build.md#options). +`dotnet build` has a new option to produce more modernized build output. This *Terminal Logger* output groups errors with the project they came from, better differentiates the different target frameworks for multi-targeted projects, and provides real-time information about what the build is doing. To opt in to the new output, use the `--tl` option. For more information about this option, see [dotnet build options](../../tools/dotnet-build.md#options). ### Simplified output paths diff --git a/docs/core/whats-new/dotnet-9/overview.md b/docs/core/whats-new/dotnet-9/overview.md index 800cd017e76ea..4831ffe7ed737 100644 --- a/docs/core/whats-new/dotnet-9/overview.md +++ b/docs/core/whats-new/dotnet-9/overview.md @@ -45,7 +45,7 @@ For more information, see [What's new in the .NET 9 libraries](libraries.md). The .NET 9 SDK introduces _workload sets_, where all of your workloads stay at a single, specific version until explicitly updated. For tools, a new option for [`dotnet tool install`](../../tools/dotnet-tool-install.md) lets users (instead of tool authors) decide whether a tool is allowed to run on a newer .NET runtime version than the version the tool targets. In addition: - Unit testing has better MSBuild integration that allows you to run tests in parallel. -- The terminal logger is enabled by default and also has improved usability. For example, the total count of failures and warnings is now summarized at the end of a build. +- Terminal Logger is enabled by default and also has improved usability. For example, the total count of failures and warnings is now summarized at the end of a build. - New MSBuild script analyzers ("build checks") are available. - The SDK can detect and adjust for version mismatches between the .NET SDK and MSBuild. - The `dotnet workload history` command shows you the history of workload installations and modifications for the current .NET SDK installation. diff --git a/docs/core/whats-new/dotnet-9/sdk.md b/docs/core/whats-new/dotnet-9/sdk.md index 8c39da746f504..67c8686cad9e5 100644 --- a/docs/core/whats-new/dotnet-9/sdk.md +++ b/docs/core/whats-new/dotnet-9/sdk.md @@ -1,6 +1,6 @@ --- title: What's new in the SDK and tooling for .NET 9 -description: Learn about the new .NET SDK features introduced in .NET 9, including for unit testing, terminal logger, tool roll-forward, and build script analyzers. +description: Learn about the new .NET SDK features introduced in .NET 9, including for unit testing, Terminal Logger, tool roll-forward, and build script analyzers. titleSuffix: "" ms.date: 11/11/2024 ms.topic: whats-new @@ -12,17 +12,17 @@ This article describes new features in the .NET SDK and tooling for .NET 9. ## Unit testing -This section describes the updates to unit testing in .NET 9: running tests in parallel, and terminal logger test output. +This section describes the updates to unit testing in .NET 9: running tests in parallel, and Terminal Logger test output. ### Run tests in parallel In .NET 9, `dotnet test` is more fully integrated with MSBuild. Because MSBuild supports [building in parallel](/visualstudio/msbuild/building-multiple-projects-in-parallel-with-msbuild), you can run tests for the same project across different target frameworks in parallel. By default, MSBuild limits the number of parallel processes to the number of processors on the computer. You can also set your own limit using the [-maxcpucount](/visualstudio/msbuild/building-multiple-projects-in-parallel-with-msbuild#-maxcpucount-switch) switch. If you want to opt out of the parallelism, set the `TestTfmsInParallel` MSBuild property to `false`. -### Terminal logger test display +### Terminal Logger test display -Test result reporting for [`dotnet test`](../../tools/dotnet-test.md) is now supported directly in the MSBuild terminal logger. You get more fully featured test reporting both _while_ tests are running (displays the running test name) and _after_ tests are completed (any test errors are rendered in a better way). +Test result reporting for [`dotnet test`](../../tools/dotnet-test.md) is now supported directly in MSBuild Terminal Logger. You get more fully featured test reporting both _while_ tests are running (displays the running test name) and _after_ tests are completed (any test errors are rendered in a better way). -For more information about the terminal logger, see [dotnet build options](../../tools/dotnet-build.md#options). +For more information about Terminal Logger, see [dotnet build options](../../tools/dotnet-build.md#options). ## .NET tool roll-forward @@ -30,13 +30,13 @@ For more information about the terminal logger, see [dotnet build options](../.. A new option for [`dotnet tool install`](../../tools/dotnet-tool-install.md) lets _users_ decide how .NET tools should be run. When you install a tool via `dotnet tool install`, or when you run tool via [`dotnet tool run `](../../tools/dotnet-tool-run.md), you can specify a new flag called `--allow-roll-forward`. This option configures the tool with roll-forward mode `Major`. This mode allows the tool to run on a newer major version of .NET if the matching .NET version is not available. This feature helps early adopters use .NET tools without tool authors having to change any code. -## Terminal logger +## Terminal Logger -The terminal logger is now [enabled by default](#enabled-by-default) and also has [improved usability](#usability). +Terminal Logger is now [enabled by default](#enabled-by-default) and also has [improved usability](#usability). ### Enabled by default -Starting in .NET 9, the default experience for all .NET CLI commands that use MSBuild is terminal logger, the enhanced logging experience that was released in .NET 8. This new output uses the capabilities of modern terminals to provide functionality like: +Starting in .NET 9, the default experience for all .NET CLI commands that use MSBuild is Terminal Logger, the enhanced logging experience that was released in .NET 8. This new output uses the capabilities of modern terminals to provide functionality like: - Clickable links - Duration timers for MSBuild tasks @@ -44,9 +44,9 @@ Starting in .NET 9, the default experience for all .NET CLI commands that use MS The output is more condensed and usable than the existing MSBuild console logger. -The new logger attempts to auto-detect if it can be used, but you can also manually control whether terminal logger is used. Specify the `--tl:off` command-line option to disable terminal logger for a specific command. Or, to disable terminal logger more broadly, set the `MSBUILDTERMINALLOGGER` environment variable to `off`. +The new logger attempts to auto-detect if it can be used, but you can also manually control whether Terminal Logger is used. Specify the `--tl:off` command-line option to disable Terminal Logger for a specific command. Or, to disable Terminal Logger more broadly, set the `MSBUILDTERMINALLOGGER` environment variable to `off`. -The set of commands that uses terminal logger by default is: +The set of commands that uses Terminal Logger by default is: - `build` - `clean` @@ -58,7 +58,7 @@ The set of commands that uses terminal logger by default is: ### Usability -The terminal logger now summarizes the total count of failures and warnings at the end of a build. It also shows errors that contain newlines. (For more information about the terminal logger, see ['dotnet build' options](../../tools/dotnet-build.md#options), specifically the `--tl` option.) +Terminal Logger now summarizes the total count of failures and warnings at the end of a build. It also shows errors that contain newlines. (For more information about Terminal Logger, see ['dotnet build' options](../../tools/dotnet-build.md#options), specifically the `--tl` option.) Consider the following project file that emits a warning when the project is built: @@ -109,7 +109,7 @@ Build succeeded with 3 warning(s) in 0.8s The message lines of the warning no longer have the repeated project and location information that clutter the display. In addition, the build summary shows how many warnings (and errors, if there are any) were generated during the build. -If you have feedback about the terminal logger, you can provide it in the [MSBuild repository](https://github.com/dotnet/msbuild/issues). +If you have feedback about Terminal Logger, you can provide it in the [MSBuild repository](https://github.com/dotnet/msbuild/issues). ## Faster NuGet dependency resolution for large repos diff --git a/includes/cli-tl.md b/includes/cli-tl.md index 3a9b8758e9c92..616a01b0efb60 100644 --- a/includes/cli-tl.md +++ b/includes/cli-tl.md @@ -4,9 +4,9 @@ ms.topic: include --- - **`--tl:[auto|on|off]`** - Specifies whether the *terminal logger* should be used for the build output. The default is `auto`, which first verifies the environment before enabling terminal logging. The environment check verifies that the terminal is capable of using modern output features and isn't using a redirected standard output before enabling the new logger. `on` skips the environment check and enables terminal logging. `off` skips the environment check and uses the default console logger. + Specifies whether *Terminal Logger* should be used for the build output. The default is `auto`, which first verifies the environment before enabling terminal logging. The environment check verifies that the terminal is capable of using modern output features and isn't using a redirected standard output before enabling the new logger. `on` skips the environment check and enables terminal logging. `off` skips the environment check and uses the default console logger. - The terminal logger shows you the restore phase followed by the build phase. During each phase, the currently building projects appear at the bottom of the terminal. Each project that's building outputs both the MSBuild target currently being built and the amount of time spent on that target. You can search this information to learn more about the build. When a project is finished building, a single "build completed" section is written that captures: + Terminal Logger shows you the restore phase followed by the build phase. During each phase, the currently building projects appear at the bottom of the terminal. Each project that's building outputs both the MSBuild target currently being built and the amount of time spent on that target. You can search this information to learn more about the build. When a project is finished building, a single "build completed" section is written that captures: - The name of the built project. - The target framework (if multi-targeted). From 8e2fb40d398aeab0daa4ca2b8b0927fa499cdf7a Mon Sep 17 00:00:00 2001 From: fcdeveloper00 Date: Mon, 29 Sep 2025 12:13:38 -0700 Subject: [PATCH 7/9] Update httpclient.md (#48217) * Update httpclient.md * Update httpclient.md some grammatical fixes. * Fix formatting in HTTP client documentation --------- Co-authored-by: Meaghan Osagie (Lewis) --- docs/fundamentals/networking/http/httpclient.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/docs/fundamentals/networking/http/httpclient.md b/docs/fundamentals/networking/http/httpclient.md index 50563d60ad4ce..67f901eaa5a1d 100644 --- a/docs/fundamentals/networking/http/httpclient.md +++ b/docs/fundamentals/networking/http/httpclient.md @@ -170,7 +170,7 @@ The code completes the following tasks: #### Create the HTTP POST request as JSON -To automatically serialize `POST` request arguments and deserialize responses into strongly typed C# objects, use the extension method that's part of the [System.Net.Http.Json](https://www.nuget.org/packages/System.Net.Http.Json) NuGet package. +To automatically serialize `POST` request arguments and deserialize responses into strongly typed C# objects, use the and the extension methods, respectively, that are part of the [System.Net.Http.Json](https://www.nuget.org/packages/System.Net.Http.Json) NuGet package. :::code source="../snippets/httpclient/Program.PostAsJson.cs" id="postasjson"::: @@ -194,7 +194,8 @@ The code completes the following tasks: #### Create the HTTP PUT request as JSON -To automatically serialize `PUT` request arguments and deserialize responses into strongly typed C# objects, use the extension method that's part of the [System.Net.Http.Json](https://www.nuget.org/packages/System.Net.Http.Json) NuGet package. +To automatically serialize `PUT` request arguments and deserialize responses into strongly typed C# objects, use the and the + extension methods, respectively, that are part of the [System.Net.Http.Json](https://www.nuget.org/packages/System.Net.Http.Json) NuGet package. :::code source="../snippets/httpclient/Program.PutAsJson.cs" id="putasjson"::: From 36487da43ba7918625a1a80c367ac3791a490afe Mon Sep 17 00:00:00 2001 From: Ophura <8chan.com@gmail.com> Date: Mon, 29 Sep 2025 21:43:17 +0200 Subject: [PATCH 8/9] fixed a compile-time error in type-marshalling.md (#48780) * fixed a compile-time error in type-marshalling.md this change adds the `out` keyword to fix such compile-time error as well as inlines the variable declaration for simplicity and renames the variable from `st` to `systemTime` for both clarity and consistency. * further improved a code block in `type-marshalling.md` this change makes the code block ready-to-run for ease of use with copying. --- .../native-interop/type-marshalling.md | 43 ++++++++++--------- 1 file changed, 23 insertions(+), 20 deletions(-) diff --git a/docs/standard/native-interop/type-marshalling.md b/docs/standard/native-interop/type-marshalling.md index 4bce686fbf5da..f05e60ffac31c 100644 --- a/docs/standard/native-interop/type-marshalling.md +++ b/docs/standard/native-interop/type-marshalling.md @@ -99,31 +99,34 @@ When you are calling methods on COM objects in .NET, the .NET runtime changes th Another aspect of type marshalling is how to pass in a struct to an unmanaged method. For instance, some of the unmanaged methods require a struct as a parameter. In these cases, you need to create a corresponding struct or a class in managed part of the world to use it as a parameter. However, just defining the class isn't enough, you also need to instruct the marshaller how to map fields in the class to the unmanaged struct. Here the `StructLayout` attribute becomes useful. ```csharp -[LibraryImport("kernel32.dll")] -static partial void GetSystemTime(out SystemTime systemTime); +using System; +using System.Runtime.InteropServices; -[StructLayout(LayoutKind.Sequential)] -struct SystemTime -{ - public ushort Year; - public ushort Month; - public ushort DayOfWeek; - public ushort Day; - public ushort Hour; - public ushort Minute; - public ushort Second; - public ushort Millisecond; -} +Win32Interop.GetSystemTime(out Win32Interop.SystemTime systemTime); + +Console.WriteLine(systemTime.Year); -public static void Main(string[] args) +internal static partial class Win32Interop { - SystemTime st = new SystemTime(); - GetSystemTime(st); - Console.WriteLine(st.Year); + [LibraryImport("kernel32.dll")] + internal static partial void GetSystemTime(out SystemTime systemTime); + + [StructLayout(LayoutKind.Sequential)] + internal ref struct SystemTime + { + public ushort Year; + public ushort Month; + public ushort DayOfWeek; + public ushort Day; + public ushort Hour; + public ushort Minute; + public ushort Second; + public ushort Millisecond; + } } ``` -The previous code shows a simple example of calling into `GetSystemTime()` function. The interesting bit is on line 4. The attribute specifies that the fields of the class should be mapped sequentially to the struct on the other (unmanaged) side. This means that the naming of the fields isn't important, only their order is important, as it needs to correspond to the unmanaged struct, shown in the following example: +The previous code shows a simple example of calling into `GetSystemTime()` function. The interesting bit is on line 13. The attribute specifies that the fields of the class should be mapped sequentially to the struct on the other (unmanaged) side. This means that the naming of the fields isn't important, only their order is important, as it needs to correspond to the unmanaged struct, shown in the following example: ```c typedef struct _SYSTEMTIME { @@ -135,7 +138,7 @@ typedef struct _SYSTEMTIME { WORD wMinute; WORD wSecond; WORD wMilliseconds; -} SYSTEMTIME, *PSYSTEMTIME; +} SYSTEMTIME, *PSYSTEMTIME, *LPSYSTEMTIME; ``` Sometimes the default marshalling for your structure doesn't do what you need. The [Customizing structure marshalling](customize-struct-marshalling.md) article teaches you how to customize how your structure is marshalled. From 699c9132ed15a4e58d13b5817f74e92675a5e0c1 Mon Sep 17 00:00:00 2001 From: Genevieve Warren <24882762+gewarren@users.noreply.github.com> Date: Mon, 29 Sep 2025 16:35:42 -0700 Subject: [PATCH 9/9] Revise breaking change documentation guidelines (#48784) Updated breaking change documentation with optimized instructions and clarified formatting. --- .github/prompts/breaking-change.md | 105 +++++++++++++++++++---------- 1 file changed, 71 insertions(+), 34 deletions(-) diff --git a/.github/prompts/breaking-change.md b/.github/prompts/breaking-change.md index 8c130ef275dc6..e564f7879cc48 100644 --- a/.github/prompts/breaking-change.md +++ b/.github/prompts/breaking-change.md @@ -1,61 +1,98 @@ -When you're assigned an issue that's labeled "breaking-change", or when you're given a link to an issue with this prompt file as context and asked to create a new breaking change document, follow these guidelines: +# Copilot-Optimized Instructions: Breaking Change Documentation -The document should be in Markdown format. +## When to use this prompt -Ignore all breaking change documentation under https://github.com/dotnet/docs/tree/main/docs/framework/migration-guide - that's for legacy .NET Framework breaking changes. Modern .NET breaking changes live in the https://github.com/dotnet/docs/tree/main/docs/core/compatibility folder and its subfolders. +- If assigned an issue labeled `breaking-change` +- If given a link to an issue referencing this prompt and asked to create a breaking change document -Rephrase all content to be clear and concise, if necessary. +## General rules -Describe previous behavior in past tense and new behavior in present tense. +- **Format:** Use Markdown +- **Scope:** + - Ignore docs under [`docs/framework/migration-guide`](https://github.com/dotnet/docs/tree/main/docs/framework/migration-guide) (for legacy .NET Framework) + - Document ONLY modern .NET breaking changes +- **Writing style:** + - Make content clear and concise + - Previous behavior: **past tense** + - New behavior: **present tense** -The document should start with the following header, including --- characters. Placeholder text is shown in angle brackets. +## Document structure - --- - title: "Breaking change - " - description: "Learn about the breaking change in where ." - ms.date: - ai-usage: ai-assisted - ms.custom: - --- +Start with this header (replace placeholders): -After the header, include the following sections in this order. Use the description in parentheses as a guide for the content of each section. +``` +--- +title: "Breaking change - " +description: "Learn about the breaking change in where ." +ms.date: +ai-usage: ai-assisted +ms.custom: +--- +``` +> **Note:** Use today's date in the format MM/DD/YYYY. This date cannot be earlier than 9/29/2025. -h1: "(The same title used in the document header, sans 'Breaking Change - ')" +Then include these sections in this order: - (An introductory paragraph summarizing the breaking change. Include the major version but not the preview number.) +### 1. H1 Title -h2: Version introduced +- Use the header title, **removing "Breaking change - "**. - (The version in which the breaking change was introduced. Include the preview number here, if given.) +**Intro paragraph:** +Summarize the breaking change. Include the major version (omit preview number). -h2: Previous behavior +### 2. Version introduced - (A brief description of the behavior before the change, including an example code snippet if applicable.) +- Version where change was introduced (include preview number if applicable). -h2: New behavior +### 3. Previous behavior - (A brief description of the behavior after the change, including an example code snippet if applicable.) +- Briefly describe past behavior. +- Include example code snippets if relevant. -h2: Type of breaking change +### 4. New behavior - If the type of breaking change is "behavioral change", add the following sentence (without the backticks): `This is a [behavioral change](../../categories.md#behavioral-change).` +- Briefly describe new behavior. +- Include example code snippets if relevant. - If the type of breaking change is "source incompatible" or "binary incompatible", add the following sentence (without the backticks): `This change can affect [source compatibility](../../categories.md#source-compatibility).` or `This change can affect [binary compatibility](../../categories.md#binary-compatibility).` +### 5. Type of breaking change - If the issue lists multiple types of breaking changes, create a single sentence that links to each applicable type, such as "This is both a []() and []() change.". If there is no type of breaking change selected in the issue, write "TODO: Add type of breaking change." +- If **behavioral change**: + `This is a [behavioral change](../../categories.md#behavioral-change).` +- If **source or binary incompatible**: + `This change can affect [source compatibility](../../categories.md#source-incompatible) and/or [binary compatibility](../../categories.md#binary-incompatible).` +- If multiple types: + Link to each type in a single sentence. +- If none specified: + State "No specific type listed." -h2: Reason for change +### 6. Reason for change - (The complete reasoning behind the change, including any relevant links.) +- Explain why the change was made. +- Include relevant links. -h2: Recommended action +### 7. Recommended action - (A brief description of the action or actions that users should take, including example code snippets if applicable.) +- Describe what users should do to adapt. +- Include code examples if helpful. -h2: Affected APIs +### 8. Affected APIs - (A bullet list of APIs that are affected by the change. If there are no affected APIs (or "No response") write "None.". Use xref-style links as described in the copilot-instructions.md file. At the end of each doc ID, add "?displayProperty=fullName", for example "".) +- Bullet list of affected APIs. +- Use **xref-style links** as described in `copilot-instructions.md`. +- If none: Write "None." -Then, add the new document to the TOC file located at https://github.com/dotnet/docs/blob/main/docs/core/compatibility/toc.yml. Also add an entry to the index file under the appropriate area H2 heading in the https://github.com/dotnet/docs/blob/main/docs/core/compatibility/10.0.md file by adding a row to the table (create a new heading/table if it doesn't exist yet). +## Final steps -Next, create a pull request. In the description, include the text "Fixes #\", where "issue-number" is the GitHub issue number. +- **Add the new doc to the [TOC file](https://github.com/dotnet/docs/blob/main/docs/core/compatibility/toc.yml).** +- **Add an entry to the index file under the appropriate area H2 heading.** +- **Create a pull request.** + - In the description, include: `Fixes #` (replace with the correct number). + - Request review on the pull request from the person who opened the issue. +- Also check the relevant API docs, if applicable, and update them in the https://github.com/dotnet/dotnet-api-docs repo to reflect the breaking change. + +--- + +**Copilot optimization notes:** +- All steps and formatting are condensed and clarified for rapid, accurate document drafting. +- Section ordering and linking instructions are explicit for automation. +- Xref/linking and PR closing instructions are surfaced for easy action.