From f09a34a5e18259b36e460ddb2a52104ea92e7cfc Mon Sep 17 00:00:00 2001 From: Cam Soper Date: Thu, 10 Apr 2025 22:07:31 +0000 Subject: [PATCH 1/5] [Breaking change]: System.Linq.AsyncEnumerable in .NET 10 Fixes #44886 --- docs/core/compatibility/core-libraries/10.0/asyncenumerable.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md index c72b3f56fd601..c8cf287334071 100644 --- a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md +++ b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md @@ -46,5 +46,5 @@ Most consuming code will not need changes, but some call sites might need update ## Affected APIs -- `System.Linq.AsyncEnumerable` +- - From e346bd350be462d5753b2be3bf9ecd38bf86e6b7 Mon Sep 17 00:00:00 2001 From: Cam Soper Date: Thu, 10 Apr 2025 22:31:28 +0000 Subject: [PATCH 2/5] Added xrefs, more links, some clarification --- .../core-libraries/10.0/asyncenumerable.md | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md index c8cf287334071..036dfe43bd603 100644 --- a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md +++ b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md @@ -8,7 +8,7 @@ ms.custom: https://github.com/dotnet/docs/issues/44886 # System.Linq.AsyncEnumerable in .NET 10 -.NET 10 introduces the `AsyncEnumerable` class, which provides a full set of LINQ extension methods for the type. This class replaces the community-maintained `System.Linq.Async` NuGet library, potentially causing compilation errors due to ambiguities. +.NET 10 introduces the class, which provides a full set of LINQ extension methods for the type. This class replaces the [community-maintained `System.Linq.Async` NuGet library](https://www.nuget.org/packages/System.Linq.Async), potentially causing compilation errors due to ambiguities. ## Version introduced @@ -16,11 +16,11 @@ ms.custom: https://github.com/dotnet/docs/issues/44886 ## Previous behavior -The `AsyncEnumerable` class in the `System.Linq.Async` package provided LINQ support for . +The `AsyncEnumerable` class in the [community-maintained `System.Linq.Async` package](https://www.nuget.org/packages/System.Linq.Async) provided LINQ support for . ## New behavior -The `AsyncEnumerable` class in .NET 10, as well as in the `System.Linq.AsyncEnumerable` NuGet package, provides LINQ support for . +The class in .NET 10, as well as in the [`System.Linq.AsyncEnumerable` NuGet package](https://www.nuget.org/packages/System.Linq.AsyncEnumerable/), provides LINQ support for . ## Type of breaking change @@ -44,7 +44,9 @@ If `System.Linq.Async` is consumed indirectly via another package, avoid ambigui Most consuming code will not need changes, but some call sites might need updates to refer to newer names and signatures. +Refer to the API documentation for the full set of LINQ extension methods available for `IAsyncEnumerable`. + ## Affected APIs - -- +- From cd14edbde59debc7d3970aaf9bad30eadc12a7e5 Mon Sep 17 00:00:00 2001 From: Cam Soper Date: Thu, 10 Apr 2025 22:33:18 +0000 Subject: [PATCH 3/5] one more --- docs/core/compatibility/core-libraries/10.0/asyncenumerable.md | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md index 036dfe43bd603..2c3f4ac854e17 100644 --- a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md +++ b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md @@ -50,3 +50,4 @@ Refer to the API documentation for the full s - - +- [System.Linq.Async package](https://www.nuget.org/packages/System.Linq.Async) (community-maintained) From becbd20b7a3a9a4df70d29bf573ce36473f179a9 Mon Sep 17 00:00:00 2001 From: Cam Soper Date: Thu, 10 Apr 2025 22:59:04 +0000 Subject: [PATCH 4/5] more xrefs --- docs/core/compatibility/core-libraries/10.0/asyncenumerable.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md index 2c3f4ac854e17..a37a6b33dcb45 100644 --- a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md +++ b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md @@ -44,7 +44,7 @@ If `System.Linq.Async` is consumed indirectly via another package, avoid ambigui Most consuming code will not need changes, but some call sites might need updates to refer to newer names and signatures. -Refer to the API documentation for the full set of LINQ extension methods available for `IAsyncEnumerable`. +Refer to the [System.Linq.AsyncEnumerable API documentation](xref:System.Linq.AsyncEnumerable) for the full set of LINQ extension methods available for . ## Affected APIs From a8c4c57eb0497c1664df7f6d06ea634148bc37e8 Mon Sep 17 00:00:00 2001 From: Cam Soper Date: Thu, 10 Apr 2025 23:30:49 +0000 Subject: [PATCH 5/5] Acrolinx pass --- .../compatibility/core-libraries/10.0/asyncenumerable.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md index a37a6b33dcb45..635c39470324c 100644 --- a/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md +++ b/docs/core/compatibility/core-libraries/10.0/asyncenumerable.md @@ -20,7 +20,7 @@ The `AsyncEnumerable` class in the [community-maintained `System.Linq.Async` pac ## New behavior -The class in .NET 10, as well as in the [`System.Linq.AsyncEnumerable` NuGet package](https://www.nuget.org/packages/System.Linq.AsyncEnumerable/), provides LINQ support for . +The class in .NET 10, and in the [`System.Linq.AsyncEnumerable` NuGet package](https://www.nuget.org/packages/System.Linq.AsyncEnumerable/), provides LINQ support for . ## Type of breaking change @@ -28,7 +28,7 @@ This is a [source incompatible](../../categories.md#source-compatibility) change ## Reason for change - has become core enough that the platform itself should provide LINQ support for the type. Community support, including from the maintainers of `System.Linq.Async`, petitioned for this inclusion directly in the platform. + is a commonly used interface, so the platform itself should provide LINQ support for the type. Maintainers of `System.Linq.Async` and other community members petitioned for inclusion directly in the platform. ## Recommended action @@ -42,7 +42,7 @@ If `System.Linq.Async` is consumed indirectly via another package, avoid ambigui ``` -Most consuming code will not need changes, but some call sites might need updates to refer to newer names and signatures. +Most consuming code should be compatible without changes, but some call sites might need updates to refer to newer names and signatures. Refer to the [System.Linq.AsyncEnumerable API documentation](xref:System.Linq.AsyncEnumerable) for the full set of LINQ extension methods available for .