Automatically port System.Text.Json.Serialization.JsonConverter`1 (#2888)

* Automatically port System.Text.Json.Serialization.JsonConverter`1

* Applied edits.

* suggestion by Jozkee

Co-Authored-By: David Cantu <[email protected]>

Author: 2 people

xml/System.Text.Json.Serialization/JsonConverter`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 type of object or value handled by the converter.</typeparam>
+    <summary>Converts an object or value to or from JSON.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -35,7 +35,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new <see cref="T:System.Text.Json.Serialization.JsonConverter`1" /> instance.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -58,10 +58,18 @@
         <Parameter Name="typeToConvert" Type="System.Type" />
       </Parameters>
       <Docs>
-        <param name="typeToConvert">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
-        <remarks>To be added.</remarks>
+         <param name="typeToConvert">The type to compare against.</param>
+        <summary>Determines whether the specified type can be converted.</summary>
+        <returns><see langword="true" /> if the type can be converted; otherwise, <see langword="false" />.</returns>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+The default implementation is to return `true` when `typeToConvert` equals `typeof(T)`.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
     <Member MemberName="Read">
@@ -85,11 +93,11 @@
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" />
       </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>
+        <param name="reader">The reader.</param>
+        <param name="typeToConvert">The type to convert.</param>
+        <param name="options">An object that specifies serialization options to use.</param>
+        <summary>Reads and converts the JSON to type <typeparamref name="T" />.</summary>
+        <returns>The converted value.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -114,12 +122,20 @@
         <Parameter Name="options" Type="System.Text.Json.JsonSerializerOptions" />
       </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 writer to write to.</param>
+        <param name="value">The value to convert to JSON.</param>
+        <param name="options">An object that specifies serialization options to use.</param>
+        <summary>Writes a specified value as JSON.</summary>
+        <remarks>
+          <format type="text/markdown"><![CDATA[
+
+## Remarks
+
+A converter may throw any exception, but it should throw <xref:System.Text.Json.JsonException> when the JSON cannot be created.
+
+          ]]></format>
+        </remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>