Document System.Array.Reverse (#3625)

* Document System.Array.Reverse

* suggestions by Jozkee

Co-Authored-By: David Cantu <[email protected]>

Author: carlossanlop

xml/System/Array.xml

@@ -6350,7 +6350,7 @@ int[,,] TDArray = new int[1,1,1];
         <param name="array">The one-dimensional <see cref="T:System.Array" /> to reverse.</param>
         <param name="index">The starting index of the section to reverse.</param>
         <param name="length">The number of elements in the section to reverse.</param>
-        <summary>Reverses the sequence of the elements in a range of elements in the one-dimensional <see cref="T:System.Array" />.</summary>
+        <summary>Reverses the sequence of a subset of the elements in the one-dimensional <see cref="T:System.Array" />.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[  
 
@@ -6416,10 +6416,14 @@ int[,,] TDArray = new int[1,1,1];
         <Parameter Name="array" Type="T[]" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="array">To be added.</param>
-        <summary>To be added.</summary>
+        <typeparam name="T">The type of the elements in <paramref name="array" />.</typeparam>
+        <param name="array">The one-dimensional array of elements to reverse.</param>
+        <summary>Reverses the sequence of the elements in the one-dimensional generic array.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="array" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.RankException">
+          <paramref name="array" /> is multidimensional.</exception>
       </Docs>
     </Member>
     <Member MemberName="Reverse&lt;T&gt;">
@@ -6454,12 +6458,24 @@ int[,,] TDArray = new int[1,1,1];
         <Parameter Name="length" Type="System.Int32" Index="2" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="array">To be added.</param>
-        <param name="index">To be added.</param>
-        <param name="length">To be added.</param>
-        <summary>To be added.</summary>
+        <typeparam name="T">The type of the elements in <paramref name="array" />.</typeparam>
+        <param name="array">The one-dimensional array of elements to reverse.</param>
+        <param name="index">The starting index of the section to reverse.</param>
+        <param name="length">The number of elements in the section to reverse.</param>
+        <summary>Reverses the sequence of a subset of the elements in the one-dimensional generic array.</summary>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="array" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.RankException">
+          <paramref name="array" /> is multidimensional.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">
+          <paramref name="index" /> is less than the lower bound of <paramref name="array" />.  
+  
+ -or-  
+  
+ <paramref name="length" /> is less than zero.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="index" /> and <paramref name="length" /> do not specify a valid range in <paramref name="array" />.</exception>
       </Docs>
     </Member>
     <MemberGroup MemberName="SetValue">