Update collections EnsureCapacity docs (#9530)

jkotas · web-flow · commit 0e96164ebf2c · 2024-01-02T09:09:53.000-08:00
diff --git a/xml/System.Collections.Generic/HashSet`1.xml b/xml/System.Collections.Generic/HashSet`1.xml
@@ -1194,7 +1194,7 @@
       </Parameters>
       <Docs>
         <param name="capacity">The minimum capacity to ensure.</param>
-        <summary>Ensures that this hash set can hold the specified number of elements without growing.</summary>
+        <summary>Ensures that this hash set can hold the specified number of elements without any further expansion of its backing storage.</summary>
         <returns>The new capacity of this instance.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
diff --git a/xml/System.Collections.Generic/List`1.xml b/xml/System.Collections.Generic/List`1.xml
@@ -1495,7 +1495,7 @@
       </Parameters>
       <Docs>
         <param name="capacity">The minimum capacity to ensure.</param>
-        <summary>Ensures that the capacity of this list is at least the specified <paramref name="capacity" />. If the current capacity is less than <paramref name="capacity" />, it is successively increased to twice the current capacity until it is at least the specified <paramref name="capacity" />.</summary>
+        <summary>Ensures that the capacity of this list is at least the specified <paramref name="capacity" />. If the current capacity is less than <paramref name="capacity" />, it is increased to at least the specified <paramref name="capacity" />.</summary>
         <returns>The new capacity of this list.</returns>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Collections.Generic/Queue`1.xml b/xml/System.Collections.Generic/Queue`1.xml
@@ -780,7 +780,7 @@
       </Parameters>
       <Docs>
         <param name="capacity">The minimum capacity to ensure.</param>
-        <summary>Ensures that the capacity of this queue is at least the specified <paramref name="capacity" />. If the current capacity is less than <paramref name="capacity" />, it is successively increased to twice the current capacity until it is at least the specified <paramref name="capacity" />.</summary>
+        <summary>Ensures that the capacity of this queue is at least the specified <paramref name="capacity" />. If the current capacity is less than <paramref name="capacity" />, it is increased to at least the specified <paramref name="capacity" />.</summary>
         <returns>The new capacity of this queue.</returns>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Collections.Generic/Stack`1.xml b/xml/System.Collections.Generic/Stack`1.xml
@@ -681,7 +681,7 @@
       </Parameters>
       <Docs>
         <param name="capacity">The minimum capacity to ensure.</param>
-        <summary>Ensures that the capacity of this Stack is at least the specified <paramref name="capacity" />. If the current capacity is less than <paramref name="capacity" />, it is successively increased to twice the current capacity until it is at least the specified <paramref name="capacity" />.</summary>
+        <summary>Ensures that the capacity of this Stack is at least the specified <paramref name="capacity" />. If the current capacity is less than <paramref name="capacity" />, it is increased to at least the specified <paramref name="capacity" />.</summary>
         <returns>The new capacity of this stack.</returns>
         <remarks>To be added.</remarks>
       </Docs>
