Document System.Enum (#3626)

* Document System.Enum

* suggestions by mairaw

Co-Authored-By: Maira Wenzel <[email protected]>

Author: carlossanlop

xml/System/Enum.xml

@@ -1314,11 +1314,17 @@ thisInstance And flag = flag
         <Parameter Name="value" Type="System.String" Index="0" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <typeparam name="TEnum">To be added.</typeparam>
-        <param name="value">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="TEnum">An enumeration type.</typeparam>
+        <param name="value">A string containing the name or value to convert.</param>
+        <summary>Converts the string representation of the name or numeric value of one or more enumerated constants specified by <typeparamref name="TEnum" /> to an equivalent enumerated object.</summary>
+        <returns>An object of type <paramref name="TEnum" /> whose value is represented by <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">
+          <typeparamref name="TEnum" /> is not an <see cref="T:System.Enum" /> type.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="value" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> does not contain enumeration information.</exception>
       </Docs>
     </Member>
     <Member MemberName="Parse&lt;TEnum&gt;">
@@ -1358,12 +1364,19 @@ thisInstance And flag = flag
         <Parameter Name="ignoreCase" Type="System.Boolean" Index="1" FrameworkAlternate="netcore-2.0;netcore-2.1;netcore-2.2;netcore-3.0;netstandard-2.1" />
       </Parameters>
       <Docs>
-        <typeparam name="TEnum">To be added.</typeparam>
-        <param name="value">To be added.</param>
-        <param name="ignoreCase">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="TEnum">An enumeration type.</typeparam>
+        <param name="value">A string containing the name or value to convert.</param>
+        <param name="ignoreCase">
+          <see langword="true" /> to ignore case; <see langword="false" /> to regard case.</param>
+        <summary>Converts the string representation of the name or numeric value of one or more enumerated constants specified by <typeparamref name="TEnum" /> to an equivalent enumerated object. A parameter specifies whether the operation is case-insensitive.</summary>
+        <returns>An object of type <paramref name="TEnum" /> whose value is represented by <paramref name="value" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">
+          <typeparamref name="TEnum" /> is not an <see cref="T:System.Enum" /> type.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="value" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="value" /> does not contain enumeration information.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.IConvertible.GetTypeCode">
@@ -1393,9 +1406,10 @@ thisInstance And flag = flag
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <summary>Returns the type code of this <see cref="T:System.Enum" /> instance.</summary>
+        <returns>An enumeration value that describes the type code of this <see cref="T:System.Enum" /> instance.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.InvalidOperationException">The enum type is unknown.</exception>
       </Docs>
     </Member>
     <Member MemberName="System.IConvertible.ToBoolean">
@@ -1981,9 +1995,9 @@ thisInstance And flag = flag
         <Parameter Name="provider" Type="System.IFormatProvider" Index="0" FrameworkAlternate="dotnet-uwp-10.0;netcore-1.0;netcore-1.1;netstandard-1.3;netstandard-1.4;netstandard-1.5;netstandard-1.6" />
       </Parameters>
       <Docs>
-        <param name="provider">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="provider">An <see cref="T:System.IFormatProvider" /> implementation that supplies culture-specific information about the format of the returned value. This argument is not used.</param>
+        <summary>This method overload is obsolete; use <see cref="M:System.Enum.ToString" /> instead.</summary>
+        <returns>The string representation of the value of this instance.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2236,7 +2250,7 @@ thisInstance And flag = flag
       </Parameters>
       <Docs>
         <param name="format">A format specification.</param>
-        <param name="provider">To be added.</param>
+        <param name="provider">An <see cref="T:System.IFormatProvider" /> implementation that supplies culture-specific information about the format of the returned value. This argument is not used.</param>
         <summary>This method overload is obsolete; use <see cref="M:System.Enum.ToString(System.String)" />.</summary>
         <returns>The string representation of the value of this instance, as specified by <paramref name="format" />.</returns>
         <remarks>To be added.</remarks>