From aa12a7c276472fe29f8e7179fee3aed2bdbd484a Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 2 Oct 2026 15:42:09 +0000
Subject: [PATCH 1/3] Initial plan


From a0deeb9677b291df121e0082e5b2d8440f5b8bd5 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 2 Oct 2026 15:44:43 +0000
Subject: [PATCH 2/3] Fix TryAddToAny overload descriptions

Co-authored-by: gewarren <24882762+gewarren@users.noreply.github.com>
---
 .../BlockingCollection`1.xml                  | 21 +++++++++----------
 1 file changed, 10 insertions(+), 11 deletions(-)

diff --git a/xml/System.Collections.Concurrent/BlockingCollection`1.xml b/xml/System.Collections.Concurrent/BlockingCollection`1.xml
index f8599e13e7c..65103f09f34 100644
--- a/xml/System.Collections.Concurrent/BlockingCollection`1.xml
+++ b/xml/System.Collections.Concurrent/BlockingCollection`1.xml
@@ -1872,16 +1872,8 @@ This member is an explicit interface member implementation. It can be used only
         <param name="collections">The array of collections.</param>
         <param name="item">The item to be added to one of the collections.</param>
         <param name="timeout">A <see cref="T:System.TimeSpan" /> that represents the number of milliseconds to wait, or a <see cref="T:System.TimeSpan" /> that represents -1 milliseconds to wait indefinitely.</param>
-        <summary>Tries to add the specified item to any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances while observing the specified cancellation token.</summary>
+        <summary>Tries to add the specified item to any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array to which the item was added, or -1 if the item could not be added.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
- This method can return early if the cancellationToken is cancelled before space was available for the Add operation.
-
- ]]></format>
-        </remarks>
         <exception cref="T:System.ObjectDisposedException">At least one of the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances has been disposed.</exception>
         <exception cref="T:System.ArgumentNullException">The <paramref name="collections" /> argument is null.</exception>
         <exception cref="T:System.ArgumentOutOfRangeException">
@@ -1939,9 +1931,16 @@ This member is an explicit interface member implementation. It can be used only
         <param name="item">The item to be added to one of the collections.</param>
         <param name="millisecondsTimeout">The number of milliseconds to wait for the collection to accept the item, or <see cref="F:System.Threading.Timeout.Infinite" /> (-1) to wait indefinitely.</param>
         <param name="cancellationToken">A cancellation token to observe.</param>
-        <summary>Tries to add the specified item to any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances.</summary>
+        <summary>Tries to add the specified item to any one of the specified <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instances while observing the specified cancellation token.</summary>
         <returns>The index of the collection in the <paramref name="collections" /> array to which the item was added, or -1 if the item could not be added.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+ This method can return early if the cancellationToken is cancelled before space was available for the Add operation.
+
+  ]]></format>
+        </remarks>
         <exception cref="T:System.OperationCanceledException">The <see cref="T:System.Threading.CancellationToken" /> is canceled.</exception>
         <exception cref="T:System.InvalidOperationException">At least one underlying collection didn't accept the item.</exception>
         <exception cref="T:System.ArgumentNullException">The <paramref name="collections" /> argument is null.</exception>

From d558b16d2e8ed165f3251b7a0851a0ae0f101d63 Mon Sep 17 00:00:00 2001
From: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
Date: Mon, 5 Oct 2026 10:24:06 -0700
Subject: [PATCH 3/3] Clarify cancellation behavior in BlockingCollection
 remarks

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
---
 xml/System.Collections.Concurrent/BlockingCollection`1.xml | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/xml/System.Collections.Concurrent/BlockingCollection`1.xml b/xml/System.Collections.Concurrent/BlockingCollection`1.xml
index 65103f09f34..2f5dd9b5926 100644
--- a/xml/System.Collections.Concurrent/BlockingCollection`1.xml
+++ b/xml/System.Collections.Concurrent/BlockingCollection`1.xml
@@ -1937,7 +1937,7 @@ This member is an explicit interface member implementation. It can be used only
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
- This method can return early if the cancellationToken is cancelled before space was available for the Add operation.
+ This method throws an <xref:System.OperationCanceledException> if `cancellationToken` is canceled before space becomes available for the add operation.
 
   ]]></format>
         </remarks>