Automatically port System.Text.Json.JsonDocumentOptions (#2885)

* Automatically port System.Text.Json.JsonDocumentOptions

* Update JsonDocumentOptions.xml

* extra endline for remarks

Author: carlossanlop

xml/System.Text.Json/JsonDocumentOptions.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides the ability for the user to define custom behavior when parsing JSON to create a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -39,9 +39,17 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>Gets or sets a value that indicates 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 extra comma at the end of a list of JSON values in an object or array is allowed; otherwise, <see langword="false"/>. Default is <see langword="false"/></value>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+By default, `AllowTrailingCommas` is set to `false`, and a <xref:System.Text.Json.JsonException> is thrown if a trailing comma is encountered.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="CommentHandling">
@@ -65,9 +73,18 @@
         <ReturnType>System.Text.Json.JsonCommentHandling</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>Gets or sets a value that determines how the <see cref="T:System.Text.Json.JsonDocument" /> 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[
+
+## Remarks
+
+By default, a <exception cref="T:System.Text.Json.JsonException> is thrown if a comment is encountered.
+
+          ]]></format>
+        </remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">The comment handling enum is set to a value that is not supported (or not within the <see cref="T:System.Text.Json.JsonCommentHandling" /> enum range).</exception>
       </Docs>
     </Member>
     <Member MemberName="MaxDepth">
@@ -91,10 +108,19 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>Gets or sets the maximum depth allowed when parsing JSON data, with the default (that is, 0) indicating a maximum depth of 64.</summary>
+        <value>The maximum depth allowed when parsing JSON data.</value>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Parsing past this depth will throw a <exception cref="T:System.Text.Json.JsonException>.
+
+          ]]></format>
+        </remarks>
+        <exception cref="T:System.ArgumentOutOfRangeException">The max depth is set to a negative value.</exception>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>