Update JsonReaderOptions.xml

Author: Ron Petrusha

xml/System.Text.Json/JsonReaderOptions.xml

@@ -34,15 +34,15 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Defines whether an extra comma at the end of a list of JSON values in an object or array is allowed (and ignored) within the JSON payload being read. By default, it's set to false, and a <exception cref="T:System.Text.Json.JsonException" /> is thrown if a trailing comma is encountered.</summary>
-        <value>To be added.</value>
+        <summary>Gets or sets a value that defines whether an extra comma at the end of a list of JSON values in an object or array is allowed (and ignored) within the JSON payload being read. </summary>
+        <value><see langword="true" /> if an exra comma is allowed; otherwise, <see langword="false" />.</value>
         <remarks>
           <format type="text/markdown">
             <![CDATA[
 
 ## Remarks
 
-By default, it's set to `false`, and <exception cref="T:System.Text.Json.JsonException> is thrown if a trailing comma is encountered.
+By default, this property is set to `false`, and a <xref:System.Text.Json.JsonException> is thrown if a trailing comma is encountered.
 
             ]]>
           </format>
@@ -65,7 +65,7 @@ By default, it's set to `false`, and <exception cref="T:System.Text.Json.JsonExc
         <ReturnType>System.Text.Json.JsonCommentHandling</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets how the <see cref="T:System.Text.Json.Utf8JsonReader" /> struct handles comments when reading through the JSON data.</summary>
+        <summary>Gets or sets a value that determines how the <see cref="T:System.Text.Json.Utf8JsonReader" /> handles comments when reading through the JSON data.</summary>
         <value>One of the enumeration values that indicates how comments are handled.</value>
         <remarks>
           <format type="text/markdown"><![CDATA[
@@ -76,7 +76,7 @@ By default, the reader throws a <xref:System.Text.Json.JsonReaderException> if i
 
  ]]></format>
         </remarks>
-        <exception cref="T:System.ArgumentOutOfRangeException">Thrown when the comment handling enum is set to a value that is not supported (i.e. not within the <see cref="T:System.Text.Json.JsonCommentHandling" /> enum range).</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">The property is being set to a value that is not a member of the <see cref="T:System.Text.Json.JsonCommentHandling" /> enumeration.</exception>
       </Docs>
     </Member>
     <Member MemberName="MaxDepth">
@@ -95,8 +95,8 @@ By default, the reader throws a <xref:System.Text.Json.JsonReaderException> if i
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets or sets the maximum depth allowed when reading JSON, with the default (i.e. 0) indicating a max depth of 64. Reading past this depth will throw a <exception cref="T:System.Text.Json.JsonException" />.</summary>
-        <value>To be added.</value>
+        <summary>Gets or sets the maximum depth allowed when reading JSON, with the default (i.e. 0) indicating a maximum depth of 64. </summary>
+        <value>The maximum depth allowed when reading JSON.</value>
         <remarks>
           <format type="text/markdown">
             <![CDATA[
@@ -108,8 +108,8 @@ Reading past this depth will throw a <exception cref="T:System.Text.Json.JsonExc
             ]]>
           </format>
         </remarks>
-        <exception cref="T:System.ArgumentOutOfRangeException">Thrown when the max depth is set to a negative value.</exception>
+        <exception cref="T:System.ArgumentOutOfRangeException">The maximum depth is being set to a negative value.</exception>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>