From f98df66a1c6300add05e50d0b1a11d03eecce1e5 Mon Sep 17 00:00:00 2001
From: Layomi Akinrinade <laakinri@microsoft.com>
Date: Thu, 16 Apr 2020 22:43:40 -0700
Subject: [PATCH 1/4] Add missing docs for System.Collections[.Generic]

---
 .../Dictionary`2.xml                          | 21 ++++----
 .../KeyValuePair`2.xml                        |  8 +--
 xml/System.Collections.Generic/Queue`1.xml    | 16 +++---
 .../ReferenceEqualityComparer.xml             | 53 +++++++++++++-----
 xml/System.Collections.Generic/Stack`1.xml    | 16 +++---
 xml/System.Collections/BitArray.xml           | 54 +++++++++++++++----
 xml/System.Collections/DictionaryEntry.xml    |  8 +--
 7 files changed, 120 insertions(+), 56 deletions(-)

diff --git a/xml/System.Collections.Generic/Dictionary`2.xml b/xml/System.Collections.Generic/Dictionary`2.xml
index aa1e1157769..327aa958f7e 100644
--- a/xml/System.Collections.Generic/Dictionary`2.xml
+++ b/xml/System.Collections.Generic/Dictionary`2.xml
@@ -1,4 +1,4 @@
-<Type Name="Dictionary&lt;TKey,TValue&gt;" FullName="System.Collections.Generic.Dictionary&lt;TKey,TValue&gt;">
+<Type Name="Dictionary&lt;TKey,TValue&gt;" FullName="System.Collections.Generic.Dictionary&lt;TKey,TValue&gt;">
   <TypeSignature Language="C#" Value="public class Dictionary&lt;TKey,TValue&gt; : System.Collections.Generic.ICollection&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;, System.Collections.Generic.IDictionary&lt;TKey,TValue&gt;, System.Collections.Generic.IEnumerable&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;, System.Collections.Generic.IReadOnlyCollection&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;, System.Collections.Generic.IReadOnlyDictionary&lt;TKey,TValue&gt;, System.Collections.IDictionary" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.6" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Dictionary`2&lt;TKey, TValue&gt; extends System.Object implements class System.Collections.Generic.ICollection`1&lt;valuetype System.Collections.Generic.KeyValuePair`2&lt;!TKey, !TValue&gt;&gt;, class System.Collections.Generic.IDictionary`2&lt;!TKey, !TValue&gt;, class System.Collections.Generic.IEnumerable`1&lt;valuetype System.Collections.Generic.KeyValuePair`2&lt;!TKey, !TValue&gt;&gt;, class System.Collections.Generic.IReadOnlyCollection`1&lt;valuetype System.Collections.Generic.KeyValuePair`2&lt;!TKey, !TValue&gt;&gt;, class System.Collections.Generic.IReadOnlyDictionary`2&lt;!TKey, !TValue&gt;, class System.Collections.ICollection, class System.Collections.IDictionary, class System.Collections.IEnumerable" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.6" />
   <TypeSignature Language="DocId" Value="T:System.Collections.Generic.Dictionary`2" />
@@ -331,8 +331,8 @@
         <Parameter Name="collection" Type="System.Collections.Generic.IEnumerable&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="collection">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="collection">The <see cref="T:System.Collections.Generic.IEnumerable`1" />  whose elements are copied to the new <see cref="T:System.Collections.Generic.Dictionary`2" />.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Collections.Generic.Dictionary`2" /> class that contains elements copied from the specified <see cref="T:System.Collections.Generic.IEnumerable`1" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -567,9 +567,9 @@
         <Parameter Name="comparer" Type="System.Collections.Generic.IEqualityComparer&lt;TKey&gt;" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="collection">To be added.</param>
-        <param name="comparer">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="collection">The <see cref="T:System.Collections.Generic.IEnumerable`1" /> whose elements are copied to the new <see cref="T:System.Collections.Generic.Dictionary`2" />.</param>
+        <param name="comparer">The <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> implementation to use when comparing keys, or <see langword="null" /> to use the default <see cref="T:System.Collections.Generic.EqualityComparer`1" /> for the type of the key.</param>
+        <summary>Initializes a new instance of the <see cref="T:System.Collections.Generic.Dictionary`2" /> class that contains elements copied from the specified <see cref="T:System.Collections.Generic.IEnumerable`1" /> and uses the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1506,10 +1506,11 @@
         <Parameter Name="value" Type="TValue" RefType="out" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="key">To be added.</param>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="key">The key of the element to remove.</param>
+        <param name="value">The removed element.</param>
+        <summary>Removes the value with the specified key from the <see cref="T:System.Collections.Generic.Dictionary`2" />, and copies the element to the <paramref name="value" /> parameter.</summary>
+        <returns>
+          <see langword="true" /> if the element is successfully found and removed; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Collections.Generic/KeyValuePair`2.xml b/xml/System.Collections.Generic/KeyValuePair`2.xml
index 9b639718393..ad93f15f07d 100644
--- a/xml/System.Collections.Generic/KeyValuePair`2.xml
+++ b/xml/System.Collections.Generic/KeyValuePair`2.xml
@@ -1,4 +1,4 @@
-<Type Name="KeyValuePair&lt;TKey,TValue&gt;" FullName="System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;">
+<Type Name="KeyValuePair&lt;TKey,TValue&gt;" FullName="System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;">
   <TypeSignature Language="C#" Value="public struct KeyValuePair&lt;TKey,TValue&gt;" />
   <TypeSignature Language="ILAsm" Value=".class public sequential ansi sealed beforefieldinit KeyValuePair`2&lt;TKey, TValue&gt; extends System.ValueType" FrameworkAlternate="dotnet-uwp-10.0;net-5.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.5;netstandard-1.6;netstandard-2.0;netstandard-2.1" />
   <TypeSignature Language="DocId" Value="T:System.Collections.Generic.KeyValuePair`2" />
@@ -159,9 +159,9 @@
         <Parameter Name="value" Type="TValue" RefType="out" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="key">To be added.</param>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="key">The key of the current <see cref="T:System.Collections.Generic.KeyValuePair`2" />.</param>
+        <param name="value">The value of the current <see cref="T:System.Collections.Generic.KeyValuePair`2" />.</param>
+        <summary>Deconstructs the current <see cref="T:System.Collections.Generic.KeyValuePair`2" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Collections.Generic/Queue`1.xml b/xml/System.Collections.Generic/Queue`1.xml
index 1eaa2b34c92..5bfd1665086 100644
--- a/xml/System.Collections.Generic/Queue`1.xml
+++ b/xml/System.Collections.Generic/Queue`1.xml
@@ -1,4 +1,4 @@
-<Type Name="Queue&lt;T&gt;" FullName="System.Collections.Generic.Queue&lt;T&gt;">
+<Type Name="Queue&lt;T&gt;" FullName="System.Collections.Generic.Queue&lt;T&gt;">
   <TypeSignature Language="C#" Value="public class Queue&lt;T&gt; : System.Collections.Generic.IEnumerable&lt;T&gt;, System.Collections.Generic.IReadOnlyCollection&lt;T&gt;, System.Collections.ICollection" FrameworkAlternate="dotnet-uwp-10.0;net-5.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-1.3;netstandard-1.4;netstandard-1.6;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Queue`1&lt;T&gt; extends System.Object implements class System.Collections.Generic.IEnumerable`1&lt;!T&gt;, class System.Collections.Generic.IReadOnlyCollection`1&lt;!T&gt;, class System.Collections.ICollection, class System.Collections.IEnumerable" FrameworkAlternate="dotnet-uwp-10.0;net-5.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netstandard-1.3;netstandard-1.4;netstandard-1.6;netstandard-2.0;netstandard-2.1" />
   <TypeSignature Language="DocId" Value="T:System.Collections.Generic.Queue`1" />
@@ -1333,9 +1333,10 @@ finally {
         <Parameter Name="result" Type="T" RefType="out" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="result">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="result">The removed object.</param>
+        <summary>Removes the object at the beginning of the <see cref="T:System.Collections.Generic.Queue`1" />, and copies it to the <paramref name="result" /> parameter.</summary>
+        <returns>
+          <see langword="true" /> if the object is successfully removed; <see langword="false" /> if the <see cref="T:System.Collections.Generic.Queue`1" /> is empty.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1368,9 +1369,10 @@ finally {
         <Parameter Name="result" Type="T" RefType="out" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="result">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="result">If present, the object at the beginning of the <see cref="T:System.Collections.Generic.Queue`1" />; otherwise, the default value of <typeparamref name="T" />.</param>
+        <summary>Returns a value that indicates whether there is an object at the beginning of the <see cref="T:System.Collections.Generic.Queue`1" />, and if one is present, copies it to the <paramref name="result" /> parameter. The object is not removed from the <see cref="T:System.Collections.Generic.Queue`1" />.</summary>
+        <returns>
+          <see langword="true" /> if there is an object at the beginning of the <see cref="T:System.Collections.Generic.Queue`1" />; <see langword="false" /> if the <see cref="T:System.Collections.Generic.Queue`1" /> is empty.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Collections.Generic/ReferenceEqualityComparer.xml b/xml/System.Collections.Generic/ReferenceEqualityComparer.xml
index 8e15b17a4d8..628aa5c7f03 100644
--- a/xml/System.Collections.Generic/ReferenceEqualityComparer.xml
+++ b/xml/System.Collections.Generic/ReferenceEqualityComparer.xml
@@ -1,4 +1,4 @@
-<Type Name="ReferenceEqualityComparer" FullName="System.Collections.Generic.ReferenceEqualityComparer">
+<Type Name="ReferenceEqualityComparer" FullName="System.Collections.Generic.ReferenceEqualityComparer">
   <TypeSignature Language="C#" Value="public sealed class ReferenceEqualityComparer : System.Collections.Generic.IEqualityComparer&lt;object&gt;, System.Collections.IEqualityComparer" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit ReferenceEqualityComparer extends System.Object implements class System.Collections.Generic.IEqualityComparer`1&lt;object&gt;, class System.Collections.IEqualityComparer" />
   <TypeSignature Language="DocId" Value="T:System.Collections.Generic.ReferenceEqualityComparer" />
@@ -21,8 +21,16 @@
     </Interface>
   </Interfaces>
   <Docs>
-    <summary>To be added.</summary>
-    <remarks>To be added.</remarks>
+    <summary>An <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> that uses reference equality (<see cref="M:System.Object.ReferenceEquals(System.Object,System.Object)" />) instead of value equality (<see cref="M:System.Object.Equals(System.Object)" />) when comparing two object instances.</summary>
+    <remarks>
+      <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The <xref:System.Collections.Generic.ReferenceEqualityComparer> type cannot be instantiated. Instead, use the <xref:System.Collections.Generic.ReferenceEqualityComparer.Instance> property to access the singleton instance of this type.
+
+          ]]></format>
+    </remarks>
   </Docs>
   <Members>
     <Member MemberName="Equals">
@@ -49,11 +57,21 @@
         <Parameter Name="y" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="x">To be added.</param>
-        <param name="y">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="x">The first object to compare.</param>
+        <param name="y">The second object to compare.</param>
+        <summary>Determines whether two object references refer to the same object instance.</summary>
+        <returns>
+          <see langword="true" /> if both <paramref name="x" /> and <paramref name="y" /> refer to the same object instance or if both are <see langword="null" />; otherwise, <see langword="false" />.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This API is a wrapper around <xref:System.Object.ReferenceEquals(System.Object,System.Object)>.
+ It is not necessarily equivalent to calling <xref:System.Object.Equals(System.Object,System.Object)>.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="GetHashCode">
@@ -79,10 +97,19 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <param name="obj">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="obj">The object for which to retrieve the hash code.</param>
+        <summary>Returns a hash code for the specified object. The returned hash code is based on the object identity, not on the contents of the object.</summary>
+        <returns>A hash code for the identity of <paramref name="obj" />.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This API is a wrapper around <xref:System.Runtime.CompilerServices.RuntimeHelpers.GetHashCode(System.Object)>.
+ It is not necessarily equivalent to calling <xref:System.Object.GetHashCode>.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Instance">
@@ -101,7 +128,7 @@
         <ReturnType>System.Collections.Generic.ReferenceEqualityComparer</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets the singleton <see cref="T:System.Collections.Generic.ReferenceEqualityComparer" /> instance.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Collections.Generic/Stack`1.xml b/xml/System.Collections.Generic/Stack`1.xml
index dda42c227b2..6481f1b6745 100644
--- a/xml/System.Collections.Generic/Stack`1.xml
+++ b/xml/System.Collections.Generic/Stack`1.xml
@@ -1,4 +1,4 @@
-<Type Name="Stack&lt;T&gt;" FullName="System.Collections.Generic.Stack&lt;T&gt;">
+<Type Name="Stack&lt;T&gt;" FullName="System.Collections.Generic.Stack&lt;T&gt;">
   <TypeSignature Language="C#" Value="public class Stack&lt;T&gt; : System.Collections.Generic.IEnumerable&lt;T&gt;, System.Collections.Generic.IReadOnlyCollection&lt;T&gt;, System.Collections.ICollection" FrameworkAlternate="dotnet-uwp-10.0;net-5.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netframework-4.6;netframework-4.6.1;netframework-4.6.2;netframework-4.7;netframework-4.7.1;netframework-4.7.2;netframework-4.8;netstandard-1.3;netstandard-1.4;netstandard-1.6;netstandard-2.0;netstandard-2.1;xamarinandroid-7.1;xamarinios-10.8;xamarinmac-3.0" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Stack`1&lt;T&gt; extends System.Object implements class System.Collections.Generic.IEnumerable`1&lt;!T&gt;, class System.Collections.Generic.IReadOnlyCollection`1&lt;!T&gt;, class System.Collections.ICollection, class System.Collections.IEnumerable" FrameworkAlternate="dotnet-uwp-10.0;net-5.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netstandard-1.3;netstandard-1.4;netstandard-1.6;netstandard-2.0;netstandard-2.1" />
   <TypeSignature Language="DocId" Value="T:System.Collections.Generic.Stack`1" />
@@ -1367,9 +1367,10 @@ finally {
         <Parameter Name="result" Type="T" RefType="out" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="result">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="result">If present, the object at the top of the <see cref="T:System.Collections.Generic.Stack`1" />; otherwise, the default value of <typeparamref name="T" />.</param>
+        <summary>Returns a value that indicates whether there is an object at the top of the <see cref="T:System.Collections.Generic.Stack`1" />, and if one is present, copies it to the <paramref name="result" /> parameter. The object is not removed from the <see cref="T:System.Collections.Generic.Stack`1" />.</summary>
+        <returns>
+          <see langword="true" /> if there is an object at the top of the <see cref="T:System.Collections.Generic.Stack`1" />; <see langword="false" /> if the <see cref="T:System.Collections.Generic.Stack`1" /> is empty.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1402,9 +1403,10 @@ finally {
         <Parameter Name="result" Type="T" RefType="out" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="result">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="result">If present, the object at the top of the <see cref="T:System.Collections.Generic.Stack`1" />; otherwise, the default value of <typeparamref name="T" />.</param>
+        <summary>Returns a value that indicates whether there is an object at the top of the <see cref="T:System.Collections.Generic.Stack`1" />, and if one is present, copies it to the <paramref name="result" /> parameter, and removes it from the <see cref="T:System.Collections.Generic.Stack`1" />.</summary>
+        <returns>
+          <see langword="true" /> if there is an object at the top of the <see cref="T:System.Collections.Generic.Stack`1" />; <see langword="false" /> if the <see cref="T:System.Collections.Generic.Stack`1" /> is empty.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
diff --git a/xml/System.Collections/BitArray.xml b/xml/System.Collections/BitArray.xml
index b5629e3de43..1052a913740 100644
--- a/xml/System.Collections/BitArray.xml
+++ b/xml/System.Collections/BitArray.xml
@@ -1,4 +1,4 @@
-<Type Name="BitArray" FullName="System.Collections.BitArray">
+<Type Name="BitArray" FullName="System.Collections.BitArray">
   <TypeSignature Language="C#" Value="public sealed class BitArray : System.Collections.ICollection" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.6" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi sealed beforefieldinit BitArray extends System.Object implements class System.Collections.ICollection, class System.Collections.IEnumerable" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.6" />
   <TypeSignature Language="DocId" Value="T:System.Collections.BitArray" />
@@ -959,10 +959,18 @@
         <Parameter Name="count" Type="System.Int32" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="count">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="count">The number of shifts to make for each bit.</param>
+        <summary>Shifts all the bit values of the current <see cref="T:System.Collections.BitArray" /> to the left on <paramref name="count" /> bits.</summary>
+        <returns>The current <see cref="T:System.Collections.BitArray" />.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The current <xref:System.Collections.BitArray> is updated and returned.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Length">
@@ -1165,10 +1173,18 @@
         <Parameter Name="count" Type="System.Int32" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="count">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="count">The number of shifts to make for each bit.</param>
+        <summary>Shifts all the bit values of the current <see cref="T:System.Collections.BitArray" /> to the right on <paramref name="count" /> bits.</summary>
+        <returns>The current <see cref="T:System.Collections.BitArray" />.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The current <xref:System.Collections.BitArray> is updated and returned.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Set">
@@ -1454,7 +1470,15 @@
       <Docs>
         <summary>Gets a value that indicates whether access to the <see cref="T:System.Collections.BitArray" /> is synchronized (thread safe).</summary>
         <value>true if access to the <see cref="T:System.Collections.BitArray" /> is synchronized (thread safe); otherwise, false.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.BitArray> instance is cast to an <xref:System.Collections.ICollection> interface.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.ICollection.SyncRoot">
@@ -1485,7 +1509,15 @@
       <Docs>
         <summary>Gets an object that can be used to synchronize access to the <see cref="T:System.Collections.BitArray" />.</summary>
         <value>An object that can be used to synchronize access to the <see cref="T:System.Collections.BitArray" />.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+This member is an explicit interface member implementation. It can be used only when the <xref:System.Collections.BitArray> instance is cast to an <xref:System.Collections.ICollection> interface.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Xor">
diff --git a/xml/System.Collections/DictionaryEntry.xml b/xml/System.Collections/DictionaryEntry.xml
index c580fb6d720..37b9d281028 100644
--- a/xml/System.Collections/DictionaryEntry.xml
+++ b/xml/System.Collections/DictionaryEntry.xml
@@ -1,4 +1,4 @@
-<Type Name="DictionaryEntry" FullName="System.Collections.DictionaryEntry">
+<Type Name="DictionaryEntry" FullName="System.Collections.DictionaryEntry">
   <TypeSignature Language="C#" Value="public struct DictionaryEntry" />
   <TypeSignature Language="ILAsm" Value=".class public sequential ansi sealed beforefieldinit DictionaryEntry extends System.ValueType" FrameworkAlternate="dotnet-uwp-10.0;net-5.0;netcore-1.0;netcore-1.1;netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netcore-3.1;netstandard-1.0;netstandard-1.1;netstandard-1.2;netstandard-1.3;netstandard-1.4;netstandard-1.5;netstandard-1.6;netstandard-2.0;netstandard-2.1" />
   <TypeSignature Language="DocId" Value="T:System.Collections.DictionaryEntry" />
@@ -165,9 +165,9 @@ The <xref:System.Collections.IDictionaryEnumerator.Entry%2A?displayProperty=name
         <Parameter Name="value" Type="System.Object" RefType="out" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1;netcore-3.1;net-5.0" />
       </Parameters>
       <Docs>
-        <param name="key">To be added.</param>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="key">The key of the current <see cref="T:System.Collections.DictionaryEntry" />.</param>
+        <param name="value">The value of the current <see cref="T:System.Collections.DictionaryEntry" />.</param>
+        <summary>Deconstructs the current <see cref="T:System.Collections.DictionaryEntry" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

From d67a3243e2198752d176ec98cfcdec796280df4b Mon Sep 17 00:00:00 2001
From: Layomi Akinrinade <laakinri@microsoft.com>
Date: Mon, 20 Apr 2020 11:38:42 -0700
Subject: [PATCH 2/4] Add exceptions

---
 xml/System.Collections.Generic/Dictionary`2.xml | 3 +++
 xml/System.Collections.Generic/Queue`1.xml      | 1 +
 xml/System.Collections/BitArray.xml             | 2 ++
 3 files changed, 6 insertions(+)

diff --git a/xml/System.Collections.Generic/Dictionary`2.xml b/xml/System.Collections.Generic/Dictionary`2.xml
index 327aa958f7e..8f65bd42e36 100644
--- a/xml/System.Collections.Generic/Dictionary`2.xml
+++ b/xml/System.Collections.Generic/Dictionary`2.xml
@@ -334,6 +334,7 @@
         <param name="collection">The <see cref="T:System.Collections.Generic.IEnumerable`1" />  whose elements are copied to the new <see cref="T:System.Collections.Generic.Dictionary`2" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Collections.Generic.Dictionary`2" /> class that contains elements copied from the specified <see cref="T:System.Collections.Generic.IEnumerable`1" />.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="ArgumentException"><paramref name="collection" /> contains one or more duplicated keys.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -571,6 +572,7 @@
         <param name="comparer">The <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> implementation to use when comparing keys, or <see langword="null" /> to use the default <see cref="T:System.Collections.Generic.EqualityComparer`1" /> for the type of the key.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Collections.Generic.Dictionary`2" /> class that contains elements copied from the specified <see cref="T:System.Collections.Generic.IEnumerable`1" /> and uses the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="ArgumentException"><paramref name="collection" /> contains one or more duplicated keys.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1512,6 +1514,7 @@
         <returns>
           <see langword="true" /> if the element is successfully found and removed; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.ICollection&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;.Add">
diff --git a/xml/System.Collections.Generic/Queue`1.xml b/xml/System.Collections.Generic/Queue`1.xml
index 5bfd1665086..58a35f8227f 100644
--- a/xml/System.Collections.Generic/Queue`1.xml
+++ b/xml/System.Collections.Generic/Queue`1.xml
@@ -1338,6 +1338,7 @@ finally {
         <returns>
           <see langword="true" /> if the object is successfully removed; <see langword="false" /> if the <see cref="T:System.Collections.Generic.Queue`1" /> is empty.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="TryPeek">
diff --git a/xml/System.Collections/BitArray.xml b/xml/System.Collections/BitArray.xml
index 1052a913740..e6bb7257940 100644
--- a/xml/System.Collections/BitArray.xml
+++ b/xml/System.Collections/BitArray.xml
@@ -971,6 +971,7 @@ The current <xref:System.Collections.BitArray> is updated and returned.
 
           ]]></format>
         </remarks>
+        <exception cref="ArgumentOutOfRangeException"><paramref name="count" /> is less than zero.</exception>
       </Docs>
     </Member>
     <Member MemberName="Length">
@@ -1185,6 +1186,7 @@ The current <xref:System.Collections.BitArray> is updated and returned.
 
           ]]></format>
         </remarks>
+        <exception cref="ArgumentOutOfRangeException"><paramref name="count" /> is less than zero.</exception>
       </Docs>
     </Member>
     <Member MemberName="Set">

From e42c4c83cca53bd5a1bf5a777c2ac09e4a26c2d1 Mon Sep 17 00:00:00 2001
From: Layomi Akinrinade <laakinri@microsoft.com>
Date: Tue, 21 Apr 2020 18:05:57 -0700
Subject: [PATCH 3/4] Add System. prefix to exceptions

---
 xml/System.Collections.Generic/Dictionary`2.xml | 6 +++---
 xml/System.Collections.Generic/Queue`1.xml      | 2 +-
 xml/System.Collections/BitArray.xml             | 4 ++--
 3 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/xml/System.Collections.Generic/Dictionary`2.xml b/xml/System.Collections.Generic/Dictionary`2.xml
index 8f65bd42e36..b7e8ca240d1 100644
--- a/xml/System.Collections.Generic/Dictionary`2.xml
+++ b/xml/System.Collections.Generic/Dictionary`2.xml
@@ -334,7 +334,7 @@
         <param name="collection">The <see cref="T:System.Collections.Generic.IEnumerable`1" />  whose elements are copied to the new <see cref="T:System.Collections.Generic.Dictionary`2" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Collections.Generic.Dictionary`2" /> class that contains elements copied from the specified <see cref="T:System.Collections.Generic.IEnumerable`1" />.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="ArgumentException"><paramref name="collection" /> contains one or more duplicated keys.</exception>
+        <exception cref="System.ArgumentException"><paramref name="collection" /> contains one or more duplicated keys.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -572,7 +572,7 @@
         <param name="comparer">The <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> implementation to use when comparing keys, or <see langword="null" /> to use the default <see cref="T:System.Collections.Generic.EqualityComparer`1" /> for the type of the key.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Collections.Generic.Dictionary`2" /> class that contains elements copied from the specified <see cref="T:System.Collections.Generic.IEnumerable`1" /> and uses the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="ArgumentException"><paramref name="collection" /> contains one or more duplicated keys.</exception>
+        <exception cref="System.ArgumentException"><paramref name="collection" /> contains one or more duplicated keys.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1514,7 +1514,7 @@
         <returns>
           <see langword="true" /> if the element is successfully found and removed; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
+        <exception cref="System.ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.ICollection&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;.Add">
diff --git a/xml/System.Collections.Generic/Queue`1.xml b/xml/System.Collections.Generic/Queue`1.xml
index 58a35f8227f..2dcf615760e 100644
--- a/xml/System.Collections.Generic/Queue`1.xml
+++ b/xml/System.Collections.Generic/Queue`1.xml
@@ -1338,7 +1338,7 @@ finally {
         <returns>
           <see langword="true" /> if the object is successfully removed; <see langword="false" /> if the <see cref="T:System.Collections.Generic.Queue`1" /> is empty.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
+        <exception cref="System.ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="TryPeek">
diff --git a/xml/System.Collections/BitArray.xml b/xml/System.Collections/BitArray.xml
index e6bb7257940..0491d5a33ef 100644
--- a/xml/System.Collections/BitArray.xml
+++ b/xml/System.Collections/BitArray.xml
@@ -971,7 +971,7 @@ The current <xref:System.Collections.BitArray> is updated and returned.
 
           ]]></format>
         </remarks>
-        <exception cref="ArgumentOutOfRangeException"><paramref name="count" /> is less than zero.</exception>
+        <exception cref="System.ArgumentOutOfRangeException"><paramref name="count" /> is less than zero.</exception>
       </Docs>
     </Member>
     <Member MemberName="Length">
@@ -1186,7 +1186,7 @@ The current <xref:System.Collections.BitArray> is updated and returned.
 
           ]]></format>
         </remarks>
-        <exception cref="ArgumentOutOfRangeException"><paramref name="count" /> is less than zero.</exception>
+        <exception cref="System.ArgumentOutOfRangeException"><paramref name="count" /> is less than zero.</exception>
       </Docs>
     </Member>
     <Member MemberName="Set">

From 3c59e62b7783c80641a83a8973dcfb64b53b10f8 Mon Sep 17 00:00:00 2001
From: Layomi Akinrinade <laakinri@microsoft.com>
Date: Mon, 27 Apr 2020 17:42:17 -0700
Subject: [PATCH 4/4] Address feedback - use tool to port exceptions

---
 xml/System.Collections.Generic/Dictionary`2.xml | 13 ++++++++++---
 xml/System.Collections.Generic/Queue`1.xml      |  3 ++-
 xml/System.Collections/BitArray.xml             |  6 ++++--
 3 files changed, 16 insertions(+), 6 deletions(-)

diff --git a/xml/System.Collections.Generic/Dictionary`2.xml b/xml/System.Collections.Generic/Dictionary`2.xml
index b7e8ca240d1..11ae9b70cee 100644
--- a/xml/System.Collections.Generic/Dictionary`2.xml
+++ b/xml/System.Collections.Generic/Dictionary`2.xml
@@ -334,7 +334,10 @@
         <param name="collection">The <see cref="T:System.Collections.Generic.IEnumerable`1" />  whose elements are copied to the new <see cref="T:System.Collections.Generic.Dictionary`2" />.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Collections.Generic.Dictionary`2" /> class that contains elements copied from the specified <see cref="T:System.Collections.Generic.IEnumerable`1" />.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="System.ArgumentException"><paramref name="collection" /> contains one or more duplicated keys.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="collection" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="collection" /> contains one or more duplicated keys.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -572,7 +575,10 @@
         <param name="comparer">The <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> implementation to use when comparing keys, or <see langword="null" /> to use the default <see cref="T:System.Collections.Generic.EqualityComparer`1" /> for the type of the key.</param>
         <summary>Initializes a new instance of the <see cref="T:System.Collections.Generic.Dictionary`2" /> class that contains elements copied from the specified <see cref="T:System.Collections.Generic.IEnumerable`1" /> and uses the specified <see cref="T:System.Collections.Generic.IEqualityComparer`1" />.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="System.ArgumentException"><paramref name="collection" /> contains one or more duplicated keys.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="collection" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="collection" /> contains one or more duplicated keys.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -1514,7 +1520,8 @@
         <returns>
           <see langword="true" /> if the element is successfully found and removed; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="System.ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.Collections.Generic.ICollection&lt;System.Collections.Generic.KeyValuePair&lt;TKey,TValue&gt;&gt;.Add">
diff --git a/xml/System.Collections.Generic/Queue`1.xml b/xml/System.Collections.Generic/Queue`1.xml
index 2dcf615760e..fa28bdb7faf 100644
--- a/xml/System.Collections.Generic/Queue`1.xml
+++ b/xml/System.Collections.Generic/Queue`1.xml
@@ -1338,7 +1338,8 @@ finally {
         <returns>
           <see langword="true" /> if the object is successfully removed; <see langword="false" /> if the <see cref="T:System.Collections.Generic.Queue`1" /> is empty.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="System.ArgumentNullException"><paramref name="key" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="key" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="TryPeek">
diff --git a/xml/System.Collections/BitArray.xml b/xml/System.Collections/BitArray.xml
index 0491d5a33ef..ad259ba6a1f 100644
--- a/xml/System.Collections/BitArray.xml
+++ b/xml/System.Collections/BitArray.xml
@@ -971,7 +971,8 @@ The current <xref:System.Collections.BitArray> is updated and returned.
 
           ]]></format>
         </remarks>
-        <exception cref="System.ArgumentOutOfRangeException"><paramref name="count" /> is less than zero.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="count" /> is less than zero.</exception>
       </Docs>
     </Member>
     <Member MemberName="Length">
@@ -1186,7 +1187,8 @@ The current <xref:System.Collections.BitArray> is updated and returned.
 
           ]]></format>
         </remarks>
-        <exception cref="System.ArgumentOutOfRangeException"><paramref name="count" /> is less than zero.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="count" /> is less than zero.</exception>
       </Docs>
     </Member>
     <Member MemberName="Set">