From 6f101fe9c68a2846537505fafa295c769b7d84ab Mon Sep 17 00:00:00 2001
From: carlossanlop <carlossanlop@users.noreply.github.com>
Date: Thu, 2 Sep 2021 21:59:21 -0700
Subject: [PATCH 1/3] Port System.Text.Json triple slash to docs

---
 .../JsonMetadataServices.xml                  |  11 +-
 .../JsonObjectInfoValues`1.xml                |  16 +-
 .../JsonParameterInfoValues.xml               |  12 +-
 .../JsonConverter`1.xml                       |  38 +-
 xml/System.Text.Json/JsonSerializer.xml       | 451 ++++++++++++------
 .../Capture.xml                               |   4 +-
 6 files changed, 360 insertions(+), 172 deletions(-)

diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
index 6f8773d8a18..91681625bbb 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
@@ -821,12 +821,13 @@
         <Parameter Name="objectInfo" Type="System.Text.Json.Serialization.Metadata.JsonObjectInfoValues&lt;T&gt;" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="options">To be added.</param>
-        <param name="objectInfo">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of the class or struct.</typeparam>
+        <param name="options">The <see cref="T:System.Text.Json.JsonSerializerOptions" /> to initialize the metadata with.</param>
+        <param name="objectInfo">Provides serialization metadata about an object type with constructors, properties, and fields.</param>
+        <summary>Creates metadata for a complex class or struct.</summary>
+        <returns>A <see cref="T:System.Text.Json.Serialization.Metadata.JsonTypeInfo`1" /> instance representing the class or struct.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="options" /> or <paramref name="objectInfo" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="CreatePropertyInfo&lt;T&gt;">
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml b/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
index 61a8a2534b2..c96a25bde89 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
@@ -17,8 +17,8 @@
   </Base>
   <Interfaces />
   <Docs>
-    <typeparam name="T">To be added.</typeparam>
-    <summary>To be added.</summary>
+    <typeparam name="T">The object type to serialize or deserialize.</typeparam>
+    <summary>Provides serialization metadata about an object type with constructors, properties, and fields.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -55,7 +55,7 @@
         <ReturnType>System.Func&lt;System.Text.Json.Serialization.Metadata.JsonParameterInfoValues[]&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Provides a mechanism to initialize metadata for a parameterized constructor of the class or struct to be used when deserializing.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -76,7 +76,7 @@
         <ReturnType>System.Text.Json.Serialization.JsonNumberHandling</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies how number properties and fields should be processed when serializing and deserializing.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -97,7 +97,7 @@
         <ReturnType>System.Func&lt;T&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Provides a mechanism to create an instance of the class or struct when deserializing, using a parameterless constructor.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -118,7 +118,7 @@
         <ReturnType>System.Func&lt;System.Object[],T&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Provides a mechanism to create an instance of the class or struct when deserializing, using a parameterized constructor.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -139,7 +139,7 @@
         <ReturnType>System.Func&lt;System.Text.Json.Serialization.JsonSerializerContext,System.Text.Json.Serialization.Metadata.JsonPropertyInfo[]&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Provides a mechanism to initialize metadata for properties and fields of the class or struct.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -160,7 +160,7 @@
         <ReturnType>System.Action&lt;System.Text.Json.Utf8JsonWriter,T&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Provides a serialization implementation for instances of the class or struct which assumes options specified by <see cref="T:System.Text.Json.Serialization.JsonSourceGenerationOptionsAttribute" />.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml b/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
index 47e7f1817ca..01be1af2630 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides information about a constructor parameter required for JSON deserialization.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -51,7 +51,7 @@
         <ReturnType>System.Object</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The default value of the parameter.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -72,7 +72,7 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Whether a default value was specified for the parameter.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -93,7 +93,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The name of the parameter.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -114,7 +114,7 @@
         <ReturnType>System.Type</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The type of the parameter.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -135,7 +135,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>The zero-based position of the parameter in the formal parameter list.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Text.Json.Serialization/JsonConverter`1.xml b/xml/System.Text.Json.Serialization/JsonConverter`1.xml
index df8285f076f..c9156288dee 100644
--- a/xml/System.Text.Json.Serialization/JsonConverter`1.xml
+++ b/xml/System.Text.Json.Serialization/JsonConverter`1.xml
@@ -184,12 +184,20 @@ For more information, see [How to write custom converters for JSON serialization
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="reader">To be added.</param>
-        <param name="typeToConvert">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+        <param name="reader">The <see cref="T:System.Text.Json.Utf8JsonReader" /> to read from.</param>
+        <param name="typeToConvert">The <see cref="T:System.Type" /> being converted.</param>
+        <param name="options">The <see cref="T:System.Text.Json.JsonSerializerOptions" /> being used.</param>
+        <summary>Reads a dictionary key from a JSON property name.</summary>
+        <returns>The value that was converted.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Method should be overridden in custom converters of types used in deserialized dictionary keys.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Write">
@@ -254,11 +262,19 @@ For more information, see [How to write custom converters for JSON serialization
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="writer">To be added.</param>
-        <param name="value">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="writer">The <see cref="T:System.Text.Json.Utf8JsonWriter" /> to write to.</param>
+        <param name="value">The value to convert. Note that the value of <seealso cref="P:System.Text.Json.Serialization.JsonConverter`1.HandleNull" /> determines if the converter handles <see langword="null" /> values.</param>
+        <param name="options">The <see cref="T:System.Text.Json.JsonSerializerOptions" /> being used.</param>
+        <summary>Writes a dictionary key as a JSON property name.</summary>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+Method should be overridden in custom converters of types used in serialized dictionary keys.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>
diff --git a/xml/System.Text.Json/JsonSerializer.xml b/xml/System.Text.Json/JsonSerializer.xml
index 4e1d5072f7c..debf5c2766a 100644
--- a/xml/System.Text.Json/JsonSerializer.xml
+++ b/xml/System.Text.Json/JsonSerializer.xml
@@ -255,10 +255,14 @@ Using a UTF-16 span is not as efficient as using the
         <exception cref="T:System.ArgumentNullException">
           <paramref name="returnType" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
-             -or- 
-             <paramref name="returnType" /> is not compatible with the JSON.
-             -or- 
-             There is remaining data in the span beyond a single JSON value.</exception>
+
+-or-
+
+<paramref name="returnType" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the span beyond a single JSON value.</exception>
         <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
       </Docs>
     </Member>
@@ -300,13 +304,19 @@ Using a <xref:System.String> is not as efficient as using the
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="json" /> or <paramref name="returnType" /> is <see langword="null" />.
-             -or- 
-             <paramref name="context" /> is <see langword="null" />.</exception>
+
+-or-
+
+<paramref name="context" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
-             -or- 
-             <paramref name="returnType" /> is not compatible with the JSON.
-             -or- 
-             There is remaining data in the string beyond a single JSON value.</exception>
+
+-or-
+
+<paramref name="returnType" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the string beyond a single JSON value.</exception>
         <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
         <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Text.Json.Serialization.JsonSerializerContext.GetTypeInfo(System.Type)" /> method of the provided <paramref name="context" /> returns <see langword="null" /> for the type to convert.</exception>
       </Docs>
@@ -418,13 +428,19 @@ Using a <xref:System.String> is not as efficient as using the
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="json" /> or <paramref name="returnType" /> is <see langword="null" />.
-             -or- 
-             <paramref name="context" /> is <see langword="null" />.</exception>
+
+-or-
+
+<paramref name="context" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
-             -or- 
-             <paramref name="returnType" /> is not compatible with the JSON.
-             -or- 
-             There is remaining data in the string beyond a single JSON value.</exception>
+
+-or-
+
+<paramref name="returnType" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the string beyond a single JSON value.</exception>
         <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
         <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Text.Json.Serialization.JsonSerializerContext.GetTypeInfo(System.Type)" /> method of the provided <paramref name="context" /> returns <see langword="null" /> for the type to convert.</exception>
       </Docs>
@@ -455,12 +471,17 @@ Using a <xref:System.String> is not as efficient as using the
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="document">To be added.</param>
-        <param name="returnType">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="document">The <see cref="T:System.Text.Json.JsonDocument" /> to convert.</param>
+        <param name="returnType">The type of the object to convert to and return.</param>
+        <param name="options">Options to control the behavior during parsing.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.JsonDocument" /> representing a single JSON value into a <paramref name="returnType" />.</summary>
+        <returns>A <paramref name="returnType" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="document" /> or <paramref name="returnType" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">
+          <paramref name="returnType" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -484,12 +505,33 @@ Using a <xref:System.String> is not as efficient as using the
         <Parameter Name="context" Type="System.Text.Json.Serialization.JsonSerializerContext" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="document">To be added.</param>
-        <param name="returnType">To be added.</param>
-        <param name="context">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="document">The <see cref="T:System.Text.Json.JsonDocument" /> to convert.</param>
+        <param name="returnType">The type of the object to convert to and return.</param>
+        <param name="context">A metadata provider for serializable types.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.JsonDocument" /> representing a single JSON value into a <paramref name="returnType" />.</summary>
+        <returns>A <paramref name="returnType" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="document" /> is <see langword="null" />.
+
+-or-
+
+<paramref name="returnType" /> is <see langword="null" />.
+
+-or-
+
+<paramref name="context" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
+
+-or-
+
+<paramref name="returnType" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the string beyond a single JSON value.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
+        <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Text.Json.Serialization.JsonSerializerContext.GetTypeInfo(System.Type)" /> method of the provided <paramref name="context" /> returns <see langword="null" /> for the type to convert.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -518,12 +560,17 @@ Using a <xref:System.String> is not as efficient as using the
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="element">To be added.</param>
-        <param name="returnType">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="element">The <see cref="T:System.Text.Json.JsonElement" /> to convert.</param>
+        <param name="returnType">The type of the object to convert to and return.</param>
+        <param name="options">Options to control the behavior during parsing.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.JsonElement" /> representing a single JSON value into a <paramref name="returnType" />.</summary>
+        <returns>A <paramref name="returnType" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="returnType" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">
+          <paramref name="returnType" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -547,12 +594,29 @@ Using a <xref:System.String> is not as efficient as using the
         <Parameter Name="context" Type="System.Text.Json.Serialization.JsonSerializerContext" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="element">To be added.</param>
-        <param name="returnType">To be added.</param>
-        <param name="context">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="element">The <see cref="T:System.Text.Json.JsonElement" /> to convert.</param>
+        <param name="returnType">The type of the object to convert to and return.</param>
+        <param name="context">A metadata provider for serializable types.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.JsonElement" /> representing a single JSON value into a <paramref name="returnType" />.</summary>
+        <returns>A <paramref name="returnType" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="returnType" /> is <see langword="null" />.
+
+-or-
+
+<paramref name="context" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
+
+-or-
+
+<paramref name="returnType" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the string beyond a single JSON value.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
+        <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Text.Json.Serialization.JsonSerializerContext.GetTypeInfo(System.Type)" /> method of the provided <paramref name="context" /> returns <see langword="null" /> for the type to convert.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -581,12 +645,15 @@ Using a <xref:System.String> is not as efficient as using the
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="node">To be added.</param>
-        <param name="returnType">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="node">The <see cref="T:System.Text.Json.Nodes.JsonNode" /> to convert.</param>
+        <param name="returnType">The type of the object to convert to and return.</param>
+        <param name="options">Options to control the behavior during parsing.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.Nodes.JsonNode" /> representing a single JSON value into a <paramref name="returnType" />.</summary>
+        <returns>A <paramref name="returnType" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.Text.Json.JsonException">
+          <paramref name="returnType" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -610,12 +677,29 @@ Using a <xref:System.String> is not as efficient as using the
         <Parameter Name="context" Type="System.Text.Json.Serialization.JsonSerializerContext" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="node">To be added.</param>
-        <param name="returnType">To be added.</param>
-        <param name="context">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="node">The <see cref="T:System.Text.Json.Nodes.JsonNode" /> to convert.</param>
+        <param name="returnType">The type of the object to convert to and return.</param>
+        <param name="context">A metadata provider for serializable types.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.Nodes.JsonNode" /> representing a single JSON value into a <paramref name="returnType" />.</summary>
+        <returns>A <paramref name="returnType" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="returnType" /> is <see langword="null" />.
+
+-or-
+
+<paramref name="context" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
+
+-or-
+
+<paramref name="returnType" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the string beyond a single JSON value.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="returnType" /> or its serializable members.</exception>
+        <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Text.Json.Serialization.JsonSerializerContext.GetTypeInfo(System.Type)" /> method of the provided <paramref name="context" /> returns <see langword="null" /> for the type to convert.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize">
@@ -973,10 +1057,14 @@ Using a UTF-16 span is not as efficient as using the
           ]]></format>
         </remarks>
         <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
-             -or- 
-             <typeparamref name="TValue" /> is not compatible with the JSON.
-             -or- 
-             There is remaining data in the span beyond a single JSON value.</exception>
+
+-or-
+
+<typeparamref name="TValue" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the span beyond a single JSON value.</exception>
         <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
@@ -1020,13 +1108,19 @@ Using a <xref:System.String> is not as efficient as using the
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="json" /> is <see langword="null" />.
-             -or- 
-             <paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
+
+-or-
+
+<paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
-             -or- 
-             <typeparamref name="TValue" /> is not compatible with the JSON.
-             -or- 
-             There is remaining data in the string beyond a single JSON value.</exception>
+
+-or-
+
+<typeparamref name="TValue" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the string beyond a single JSON value.</exception>
         <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
@@ -1133,13 +1227,19 @@ Using a <xref:System.String> is not as efficient as using the
         </remarks>
         <exception cref="T:System.ArgumentNullException">
           <paramref name="json" /> is <see langword="null" />.
-             -or- 
-             <paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
+
+-or-
+
+<paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
         <exception cref="T:System.Text.Json.JsonException">The JSON is invalid.
-             -or- 
-             <typeparamref name="TValue" /> is not compatible with the JSON.
-             -or- 
-             There is remaining data in the string beyond a single JSON value.</exception>
+
+-or-
+
+<typeparamref name="TValue" /> is not compatible with the JSON.
+
+-or-
+
+There is remaining data in the string beyond a single JSON value.</exception>
         <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
@@ -1172,11 +1272,16 @@ Using a <xref:System.String> is not as efficient as using the
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="document">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="document">The <see cref="T:System.Text.Json.JsonDocument" /> to convert.</param>
+        <param name="options">Options to control the behavior during parsing.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.JsonDocument" /> representing a single JSON value into a <typeparamref name="TValue" />.</summary>
+        <returns>A <typeparamref name="TValue" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="document" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">
+          <typeparamref name="TValue" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize&lt;TValue&gt;">
@@ -1203,11 +1308,20 @@ Using a <xref:System.String> is not as efficient as using the
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="document">To be added.</param>
-        <param name="jsonTypeInfo">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="document">The <see cref="T:System.Text.Json.JsonDocument" /> to convert.</param>
+        <param name="jsonTypeInfo">Metadata about the type to convert.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.JsonDocument" /> representing a single JSON value into a <typeparamref name="TValue" />.</summary>
+        <returns>A <typeparamref name="TValue" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="document" /> is <see langword="null" />.
+
+-or-
+
+<paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">
+          <typeparamref name="TValue" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize&lt;TValue&gt;">
@@ -1239,11 +1353,14 @@ Using a <xref:System.String> is not as efficient as using the
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="element">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="element">The <see cref="T:System.Text.Json.JsonElement" /> to convert.</param>
+        <param name="options">Options to control the behavior during parsing.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.JsonElement" /> representing a single JSON value into a <typeparamref name="TValue" />.</summary>
+        <returns>A <typeparamref name="TValue" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.Text.Json.JsonException">
+          <typeparamref name="TValue" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize&lt;TValue&gt;">
@@ -1270,11 +1387,16 @@ Using a <xref:System.String> is not as efficient as using the
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="element">To be added.</param>
-        <param name="jsonTypeInfo">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="element">The <see cref="T:System.Text.Json.JsonElement" /> to convert.</param>
+        <param name="jsonTypeInfo">Metadata about the type to convert.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.JsonElement" /> representing a single JSON value into a <typeparamref name="TValue" />.</summary>
+        <returns>A <typeparamref name="TValue" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">
+          <typeparamref name="TValue" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize&lt;TValue&gt;">
@@ -1306,11 +1428,14 @@ Using a <xref:System.String> is not as efficient as using the
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="node">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="node">The <see cref="T:System.Text.Json.Nodes.JsonNode" /> to convert.</param>
+        <param name="options">Options to control the behavior during parsing.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.Nodes.JsonNode" /> representing a single JSON value into a <typeparamref name="TValue" />.</summary>
+        <returns>A <typeparamref name="TValue" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.Text.Json.JsonException">
+          <typeparamref name="TValue" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize&lt;TValue&gt;">
@@ -1337,11 +1462,16 @@ Using a <xref:System.String> is not as efficient as using the
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="node">To be added.</param>
-        <param name="jsonTypeInfo">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="node">The <see cref="T:System.Text.Json.Nodes.JsonNode" /> to convert.</param>
+        <param name="jsonTypeInfo">Metadata about the type to convert.</param>
+        <summary>Converts the <see cref="T:System.Text.Json.Nodes.JsonNode" /> representing a single JSON value into a <typeparamref name="TValue" />.</summary>
+        <returns>A <typeparamref name="TValue" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.Text.Json.JsonException">
+          <typeparamref name="TValue" /> is not compatible with the JSON.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="Deserialize&lt;TValue&gt;">
@@ -2480,12 +2610,18 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <param name="inputType">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="inputType">The type of the <paramref name="value" /> to convert.</param>
+        <param name="options">Options to control the conversion behavior.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.JsonDocument" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="inputType" /> is not compatible with <paramref name="value" />.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="inputType" /> is <see langword="null" />.
+        </exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="inputType" />  or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToDocument">
@@ -2509,12 +2645,16 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
         <Parameter Name="context" Type="System.Text.Json.Serialization.JsonSerializerContext" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <param name="inputType">To be added.</param>
-        <param name="context">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="inputType">The type of the <paramref name="value" /> to convert.</param>
+        <param name="context">A metadata provider for serializable types.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.JsonDocument" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="inputType" /> or its serializable members.</exception>
+        <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Text.Json.Serialization.JsonSerializerContext.GetTypeInfo(System.Type)" /> method of the provided <paramref name="context" /> returns <see langword="null" /> for the type to convert.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="inputType" /> or <paramref name="context" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToDocument&lt;TValue&gt;">
@@ -2546,11 +2686,12 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="value">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="options">Options to control the conversion behavior.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.JsonDocument" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToDocument&lt;TValue&gt;">
@@ -2577,11 +2718,14 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="value">To be added.</param>
-        <param name="jsonTypeInfo">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="jsonTypeInfo">Metadata about the type to convert.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.JsonDocument" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToElement">
@@ -2610,12 +2754,18 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <param name="inputType">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="inputType">The type of the <paramref name="value" /> to convert.</param>
+        <param name="options">Options to control the conversion behavior.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.JsonDocument" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="inputType" /> is not compatible with <paramref name="value" />.</exception>
+        <exception cref="T:System.NotSupportedException">
+          <exception cref="T:System.ArgumentNullException">
+            <paramref name="inputType" /> is <see langword="null" />.
+            </exception> There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="inputType" />  or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToElement">
@@ -2639,12 +2789,16 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
         <Parameter Name="context" Type="System.Text.Json.Serialization.JsonSerializerContext" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <param name="inputType">To be added.</param>
-        <param name="context">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="inputType">The type of the <paramref name="value" /> to convert.</param>
+        <param name="context">A metadata provider for serializable types.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.JsonDocument" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="inputType" /> or its serializable members.</exception>
+        <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Text.Json.Serialization.JsonSerializerContext.GetTypeInfo(System.Type)" /> method of the provided <paramref name="context" /> returns <see langword="null" /> for the type to convert.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="inputType" /> or <paramref name="context" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToElement&lt;TValue&gt;">
@@ -2676,11 +2830,12 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="value">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="options">Options to control the conversion behavior.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.JsonDocument" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToElement&lt;TValue&gt;">
@@ -2707,11 +2862,14 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="value">To be added.</param>
-        <param name="jsonTypeInfo">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="jsonTypeInfo">Metadata about the type to convert.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.JsonDocument" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.JsonDocument" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToNode">
@@ -2740,12 +2898,17 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <param name="inputType">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="inputType">The type of the <paramref name="value" /> to convert.</param>
+        <param name="options">Options to control the conversion behavior.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.Nodes.JsonNode" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.Nodes.JsonNode" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentException">
+          <paramref name="inputType" /> is not compatible with <paramref name="value" />.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="inputType" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="inputType" />  or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToNode">
@@ -2769,12 +2932,16 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
         <Parameter Name="context" Type="System.Text.Json.Serialization.JsonSerializerContext" Index="2" FrameworkAlternate="net-6.0" />
       </Parameters>
       <Docs>
-        <param name="value">To be added.</param>
-        <param name="inputType">To be added.</param>
-        <param name="context">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="inputType">The type of the <paramref name="value" /> to convert.</param>
+        <param name="context">A metadata provider for serializable types.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.Nodes.JsonNode" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.Nodes.JsonNode" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="inputType" /> or its serializable members.</exception>
+        <exception cref="T:System.InvalidOperationException">The <see cref="M:System.Text.Json.Serialization.JsonSerializerContext.GetTypeInfo(System.Type)" /> method of the provided <paramref name="context" /> returns <see langword="null" /> for the type to convert.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="inputType" /> or <paramref name="context" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToNode&lt;TValue&gt;">
@@ -2806,11 +2973,12 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="value">To be added.</param>
-        <param name="options">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="options">Options to control the conversion behavior.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.Nodes.JsonNode" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.Nodes.JsonNode" /> representation of the JSON value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToNode&lt;TValue&gt;">
@@ -2837,11 +3005,14 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
       </Parameters>
       <Docs>
         <typeparam name="TValue">To be added.</typeparam>
-        <param name="value">To be added.</param>
-        <param name="jsonTypeInfo">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="value">The value to convert.</param>
+        <param name="jsonTypeInfo">Metadata about the type to convert.</param>
+        <summary>Converts the provided value into a <see cref="T:System.Text.Json.Nodes.JsonNode" />.</summary>
+        <returns>A <see cref="T:System.Text.Json.Nodes.JsonNode" /> representation of the value.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <typeparamref name="TValue" /> or its serializable members.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="jsonTypeInfo" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToUtf8Bytes">
diff --git a/xml/System.Text.RegularExpressions/Capture.xml b/xml/System.Text.RegularExpressions/Capture.xml
index 6f5d8de87b1..04bcbfa785b 100644
--- a/xml/System.Text.RegularExpressions/Capture.xml
+++ b/xml/System.Text.RegularExpressions/Capture.xml
@@ -335,8 +335,8 @@
         <ReturnType>System.ReadOnlySpan&lt;System.Char&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets the captured span from the input string.</summary>
+        <value>The span that is captured by the match.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

From 04e224319bfa184026ec03cc85694da59c391d60 Mon Sep 17 00:00:00 2001
From: Carlos Sanchez <1175054+carlossanlop@users.noreply.github.com>
Date: Thu, 2 Sep 2021 23:24:29 -0700
Subject: [PATCH 2/3] fix warnings

---
 xml/System.Text.Json.Serialization/JsonConverter`1.xml | 2 +-
 xml/System.Text.Json/JsonSerializer.xml                | 6 +++---
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/xml/System.Text.Json.Serialization/JsonConverter`1.xml b/xml/System.Text.Json.Serialization/JsonConverter`1.xml
index c9156288dee..9217b647ce0 100644
--- a/xml/System.Text.Json.Serialization/JsonConverter`1.xml
+++ b/xml/System.Text.Json.Serialization/JsonConverter`1.xml
@@ -263,7 +263,7 @@ For more information, see [How to write custom converters for JSON serialization
       </Parameters>
       <Docs>
         <param name="writer">The <see cref="T:System.Text.Json.Utf8JsonWriter" /> to write to.</param>
-        <param name="value">The value to convert. Note that the value of <seealso cref="P:System.Text.Json.Serialization.JsonConverter`1.HandleNull" /> determines if the converter handles <see langword="null" /> values.</param>
+        <param name="value">The value to convert. Note that the value of <see cref="P:System.Text.Json.Serialization.JsonConverter`1.HandleNull" /> determines if the converter handles <see langword="null" /> values.</param>
         <param name="options">The <see cref="T:System.Text.Json.JsonSerializerOptions" /> being used.</param>
         <summary>Writes a dictionary key as a JSON property name.</summary>
         <remarks>
diff --git a/xml/System.Text.Json/JsonSerializer.xml b/xml/System.Text.Json/JsonSerializer.xml
index debf5c2766a..c1289d8a61b 100644
--- a/xml/System.Text.Json/JsonSerializer.xml
+++ b/xml/System.Text.Json/JsonSerializer.xml
@@ -2762,10 +2762,10 @@ For more information, see [How to serialize and deserialize JSON](/dotnet/standa
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentException">
           <paramref name="inputType" /> is not compatible with <paramref name="value" />.</exception>
-        <exception cref="T:System.NotSupportedException">
-          <exception cref="T:System.ArgumentNullException">
+        <exception cref="T:System.ArgumentNullException">
             <paramref name="inputType" /> is <see langword="null" />.
-            </exception> There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="inputType" />  or its serializable members.</exception>
+        </exception>
+        <exception cref="T:System.NotSupportedException">There is no compatible <see cref="T:System.Text.Json.Serialization.JsonConverter" /> for <paramref name="inputType" />  or its serializable members.</exception>
       </Docs>
     </Member>
     <Member MemberName="SerializeToElement">

From f2f4e78ef48820c01583b9814cadc50c946cc58e Mon Sep 17 00:00:00 2001
From: Carlos Sanchez <1175054+carlossanlop@users.noreply.github.com>
Date: Wed, 8 Sep 2021 12:31:41 -0700
Subject: [PATCH 3/3] Apply suggestions from code review

Co-authored-by: Genevieve Warren <24882762+gewarren@users.noreply.github.com>
---
 .../JsonMetadataServices.xml                         |  3 ++-
 .../JsonObjectInfoValues`1.xml                       | 10 +++++-----
 .../JsonParameterInfoValues.xml                      | 10 +++++-----
 .../JsonConverter`1.xml                              | 12 ++++++------
 4 files changed, 18 insertions(+), 17 deletions(-)

diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
index 91681625bbb..0a81589ce4b 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonMetadataServices.xml
@@ -827,7 +827,8 @@
         <summary>Creates metadata for a complex class or struct.</summary>
         <returns>A <see cref="T:System.Text.Json.Serialization.Metadata.JsonTypeInfo`1" /> instance representing the class or struct.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="options" /> or <paramref name="objectInfo" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="options" /> or <paramref name="objectInfo" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="CreatePropertyInfo&lt;T&gt;">
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml b/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
index c96a25bde89..e1b53580340 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonObjectInfoValues`1.xml
@@ -76,7 +76,7 @@
         <ReturnType>System.Text.Json.Serialization.JsonNumberHandling</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Specifies how number properties and fields should be processed when serializing and deserializing.</summary>
+        <summary>Gets or sets an object that specifies how number properties and fields should be processed when serializing and deserializing.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -97,7 +97,7 @@
         <ReturnType>System.Func&lt;T&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Provides a mechanism to create an instance of the class or struct when deserializing, using a parameterless constructor.</summary>
+        <summary>Gets or sets a mechanism to create an instance of the class or struct using a parameterless constructor during deserialization.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -118,7 +118,7 @@
         <ReturnType>System.Func&lt;System.Object[],T&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Provides a mechanism to create an instance of the class or struct when deserializing, using a parameterized constructor.</summary>
+        <summary>Gets or sets a mechanism to create an instance of the class or struct using a parameterized constructor during deserialization.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -139,7 +139,7 @@
         <ReturnType>System.Func&lt;System.Text.Json.Serialization.JsonSerializerContext,System.Text.Json.Serialization.Metadata.JsonPropertyInfo[]&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Provides a mechanism to initialize metadata for properties and fields of the class or struct.</summary>
+        <summary>Gets or sets a mechanism to initialize metadata for properties and fields of the class or struct.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -160,7 +160,7 @@
         <ReturnType>System.Action&lt;System.Text.Json.Utf8JsonWriter,T&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Provides a serialization implementation for instances of the class or struct which assumes options specified by <see cref="T:System.Text.Json.Serialization.JsonSourceGenerationOptionsAttribute" />.</summary>
+        <summary>Gets or sets a serialization implementation for instances of the class or struct that assumes options specified by <see cref="T:System.Text.Json.Serialization.JsonSourceGenerationOptionsAttribute" />.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml b/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
index 01be1af2630..bcb9a1c9542 100644
--- a/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
+++ b/xml/System.Text.Json.Serialization.Metadata/JsonParameterInfoValues.xml
@@ -51,7 +51,7 @@
         <ReturnType>System.Object</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The default value of the parameter.</summary>
+        <summary>Gets or sets the default value of the parameter.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -72,7 +72,7 @@
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Whether a default value was specified for the parameter.</summary>
+        <summary>Gets or sets a value that specifies whether a default value was specified for the parameter.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -93,7 +93,7 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The name of the parameter.</summary>
+        <summary>Gets or sets the name of the parameter.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -114,7 +114,7 @@
         <ReturnType>System.Type</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The type of the parameter.</summary>
+        <summary>Gets or sets the type of the parameter.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
@@ -135,7 +135,7 @@
         <ReturnType>System.Int32</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The zero-based position of the parameter in the formal parameter list.</summary>
+        <summary>Gets or sets the zero-based position of the parameter in the formal parameter list.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>
diff --git a/xml/System.Text.Json.Serialization/JsonConverter`1.xml b/xml/System.Text.Json.Serialization/JsonConverter`1.xml
index 9217b647ce0..69a97440a78 100644
--- a/xml/System.Text.Json.Serialization/JsonConverter`1.xml
+++ b/xml/System.Text.Json.Serialization/JsonConverter`1.xml
@@ -185,8 +185,8 @@ For more information, see [How to write custom converters for JSON serialization
       </Parameters>
       <Docs>
         <param name="reader">The <see cref="T:System.Text.Json.Utf8JsonReader" /> to read from.</param>
-        <param name="typeToConvert">The <see cref="T:System.Type" /> being converted.</param>
-        <param name="options">The <see cref="T:System.Text.Json.JsonSerializerOptions" /> being used.</param>
+        <param name="typeToConvert">The type to convert.</param>
+        <param name="options">The options to use when reading the value.</param>
         <summary>Reads a dictionary key from a JSON property name.</summary>
         <returns>The value that was converted.</returns>
         <remarks>
@@ -194,7 +194,7 @@ For more information, see [How to write custom converters for JSON serialization
 
 ## Remarks
 
-Method should be overridden in custom converters of types used in deserialized dictionary keys.
+This method should be overridden in custom converters of types used in deserialized dictionary keys.
 
           ]]></format>
         </remarks>
@@ -263,15 +263,15 @@ For more information, see [How to write custom converters for JSON serialization
       </Parameters>
       <Docs>
         <param name="writer">The <see cref="T:System.Text.Json.Utf8JsonWriter" /> to write to.</param>
-        <param name="value">The value to convert. Note that the value of <see cref="P:System.Text.Json.Serialization.JsonConverter`1.HandleNull" /> determines if the converter handles <see langword="null" /> values.</param>
-        <param name="options">The <see cref="T:System.Text.Json.JsonSerializerOptions" /> being used.</param>
+        <param name="value">The value to convert. The value of <see cref="P:System.Text.Json.Serialization.JsonConverter`1.HandleNull" /> determines if the converter handles <see langword="null" /> values.</param>
+        <param name="options">The options to use when writing the value.</param>
         <summary>Writes a dictionary key as a JSON property name.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
 ## Remarks
 
-Method should be overridden in custom converters of types used in serialized dictionary keys.
+This method should be overridden in custom converters of types used in serialized dictionary keys.
 
           ]]></format>
         </remarks>