coreclr: Automatic port of triple slash from System.Collections (#2719)

* coreclr: Automatic port of triple slash from System.Collections

* suggestions by safern

Co-Authored-By: Santiago Fernandez Madero <[email protected]>

* Update Dictionary`2.xml

* Update IAsyncEnumerator`1.xml

Author: carlossanlop

xml/System.Collections.Concurrent/ConcurrentQueue`1.xml

@@ -183,7 +183,7 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Removes all objects from the <see cref="T:System.Collections.Concurrent.ConcurrentQueue`1" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -778,9 +778,17 @@
         <summary>Tries to return an object from the beginning of the <see cref="T:System.Collections.Concurrent.ConcurrentQueue`1" /> without removing it.</summary>
         <returns>
           <see langword="true" /> if an object was returned successfully; otherwise, <see langword="false" />.</returns>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+For determining whether the collection contains any items, use of the <xref:System.Collections.Concurrent.ConcurrentQueue`1.IsEmpty> property is recommended rather than peeking.
+
+          ]]></format>
+        </remarks>
         <related type="Article" href="https://msdn.microsoft.com/library/2e7ca21f-786c-4367-96be-0cf3f3dcc6bd">Thread-Safe Collections</related>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Collections.Generic/Dictionary`2.xml

@@ -1010,10 +1010,11 @@
         <Parameter Name="capacity" Type="System.Int32" Index="0" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="capacity">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="capacity">The number of entries.</param>
+        <summary>Ensures that the dictionary can hold up to a specified number of entries without any further expansion of its backing storage.</summary>
+        <returns>The current capacity of the <see cref="T:System.Collections.Generic.Dictionary`2" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="capacity" /> is less than 0.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetEnumerator">
@@ -2715,8 +2716,19 @@ finally {
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <summary>Sets the capacity of this dictionary to what it would be if it had been originally initialized with all its entries.</summary>
+        <remarks>  
+          <format type="text/markdown"><![CDATA[  
+
+This method can be used to minimize memory overhead once it is known that no new elements will be added to the dictionary. To allocate  a minimum size storage array, execute the following statements:
+
+```csharp
+dictionary.Clear();
+dictionary.TrimExcess();
+```
+
+         ]]></format>
+         </remarks>
       </Docs>
     </Member>
     <Member MemberName="TrimExcess">
@@ -2745,9 +2757,10 @@ finally {
         <Parameter Name="capacity" Type="System.Int32" Index="0" FrameworkAlternate="netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <param name="capacity">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="capacity">The new capacity.</param>
+        <summary>Sets the capacity of this dictionary to hold up a specified number of entries without any further expansion of its backing storage.</summary>
+        <remarks>This method can be used to minimize the memory overhead once it is known that no new elements will be added.</remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException"><paramref name="capacity" /> is less than <see cref="T:System.Collections.Generic.Dictionary`2" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="TryAdd">
@@ -2936,4 +2949,4 @@ Unlike the <xref:System.Collections.Generic.Dictionary%602.Add%2A> method, this
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>

xml/System.Collections.Generic/IAsyncEnumerable`1.xml

@@ -23,7 +23,7 @@
   <Interfaces />
   <Docs>
     <typeparam name="T">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <summary>Exposes an enumerator that provides asynchronous iteration over values of a specified type.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -48,9 +48,9 @@
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <param name="cancellationToken">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="cancellationToken">A <see cref="T:System.Threading.CancellationToken" /> that may be used to cancel the asynchronous iteration.</param>
+        <summary>Returns an enumerator that iterates asynchronously through the collection.</summary>
+        <returns>An enumerator that can be used to iterate asynchronously through the collection.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Collections.Generic/IAsyncEnumerator`1.xml

@@ -27,7 +27,7 @@
   </Interfaces>
   <Docs>
     <typeparam name="T">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <summary>Supports a simple asynchronous iteration over a generic collection.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -50,8 +50,8 @@
         <ReturnType>T</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the element in the collection at the current position of the enumerator.</summary>
+        <value>The element in the collection at the current position of the enumerator.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -76,10 +76,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Advances the enumerator asynchronously to the next element of the collection.</summary>
+        <returns>A <see cref="T:System.Threading.Tasks.ValueTask`1" /> that will complete with a result of <see langword="true" /> if the enumerator was successfully advanced to the next element, or <see langword="false" /> if the enumerator has passed the end of the collection.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>