Update Utf8JsonReader.xml

Author: Ron Petrusha

xml/System.Text.Json/Utf8JsonReader.xml

@@ -240,11 +240,19 @@ in more data asynchronously before continuing with a new instance of the <xref:S
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Parses the current JSON token value from the source and decodes the base 64 encoded JSON string as bytes.</summary>
-        <returns>To be added.</returns>
+        <summary>Parses the current JSON token value from the source and decodes the base 64 encoded JSON string as a byte array.</summary>
+        <returns>The byte array that represents the current JSON token value.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.InvalidOperationException">Thrown if trying to get the value of a JSON token that is not a <see cref="F:System.Text.Json.JsonTokenType.String" />. <seealso cref="P:System.Text.Json.Utf8JsonReader.TokenType" />.</exception>
-        <exception cref="T:System.FormatException">Thrown when the JSON string contains data outside of the expected base 64 range, or if it contains invalid/more than two padding characters, or is incomplete (i.e. the JSON string length is not a multiple of 4).</exception>
+        <exception cref="T:System.InvalidOperationException">The type of the JSON token is not a <see cref="F:System.Text.Json.JsonTokenType.String" />.</exception>
+        <exception cref="T:System.FormatException">The JSON string contains data outside of the expected base 64 range.
+          
+- or -
+
+The JSON string contains invalid padding characters or more than two padding characters.
+
+- or -
+          
+The JSON string is incomplete; that is, the JSON string length is not a multiple of 4.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetComment">
@@ -264,10 +272,10 @@ in more data asynchronously before continuing with a new instance of the <xref:S
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Parses the current JSON token value from the source as a comment, transcoded as a <see cref="T:System.String" />.</summary>
-        <returns>To be added.</returns>
+        <summary>Parses the current JSON token value from the source as a comment, transcoded it as a <see cref="T:System.String" />.</summary>
+        <returns>The comment that represnets the current JSON token value.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.InvalidOperationException">Thrown if trying to get the value of the JSON token that is not a comment. <seealso cref="P:System.Text.Json.Utf8JsonReader.TokenType" />.</exception>
+        <exception cref="T:System.InvalidOperationException">The JSON token that is not a comment.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetDateTime">
@@ -1299,4 +1307,4 @@ Otherwise, the token value must be accessed from <xref:System.Text.Json.Utf8Json
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>