Update JsonEncodedText.xml

Author: Ron Petrusha

xml/System.Text.Json/JsonEncodedText.xml

@@ -30,7 +30,7 @@
 
 ## Remarks
 
-This can be used to cache and store known strings used for writing JSON ahead of time by pre-encoding them up front.
+This type can be used to cache and store known strings used for writing JSON ahead of time by pre-encoding them up front.
 
             ]]>
           </format>
@@ -57,10 +57,10 @@ This can be used to cache and store known strings used for writing JSON ahead of
       </Parameters>
       <Docs>
         <param name="utf8Value">The UTF-8 encoded value to be transformed as JSON encoded text.</param>
-        <summary>Encodes the UTF-8 text value as a JSON string.</summary>
-        <returns>To be added.</returns>
+        <summary>Encodes a UTF-8 encoded byte span as a JSON string.</summary>
+        <returns>The JSON string.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentException">Thrown when the specified value is too large or if it contains invalid UTF-8 bytes.</exception>
+        <exception cref="T:System.ArgumentException"><paramref name'utf8Value" /> is too large or contains invalid UTF-8 bytes.</exception>
       </Docs>
     </Member>
     <Member MemberName="Encode">
@@ -83,10 +83,10 @@ This can be used to cache and store known strings used for writing JSON ahead of
       </Parameters>
       <Docs>
         <param name="value">The value to be transformed as JSON encoded text.</param>
-        <summary>Encodes the text value as a JSON string.</summary>
-        <returns>To be added.</returns>
+        <summary>Encodes a UTF-16 encoded character span as a JSON string.</summary>
+        <returns>The JSON string.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentException">Thrown when the specified value is too large or if it contains invalid UTF-16 characters.</exception>
+        <exception cref="T:System.ArgumentException"><paramref name="value" /> is too large or contains invalid UTF-16 characters.</exception>
       </Docs>
     </Member>
     <Member MemberName="Encode">
@@ -112,8 +112,8 @@ This can be used to cache and store known strings used for writing JSON ahead of
         <summary>Encodes the string text value as a JSON string.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">Thrown if value is null.</exception>
-        <exception cref="T:System.ArgumentException">Thrown when the specified value is too large or if it contains invalid UTF-16 characters.</exception>
+        <exception cref="T:System.ArgumentNullException"><paramref name="value" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentException"><paramref name="value" /> is too large or contains invalid UTF-16 characters.</exception>
       </Docs>
     </Member>
     <Member MemberName="EncodedUtf8Bytes">
@@ -132,8 +132,8 @@ This can be used to cache and store known strings used for writing JSON ahead of
         <ReturnType>System.ReadOnlySpan&lt;System.Byte&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Returns the UTF-8 encoded representation of the pre-encoded JSON text.</summary>
-        <value>To be added.</value>
+        <summary>Gets the UTF-8 encoded representation of the pre-encoded JSON text.</summary>
+        <value>The UTF-8 encoded representation of the pre-encoded JSON text.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -158,14 +158,14 @@ This can be used to cache and store known strings used for writing JSON ahead of
       <Docs>
         <param name="obj">To be added.</param>
         <summary>Determines whether this instance and a specified object, which must also be a <see cref="T:System.Text.Json.JsonEncodedText" /> instance, have the same value.</summary>
-        <returns>To be added.</returns>
+        <returns><see langword="true" /> if the current instance and <paramref name="obj" /> are equal; otherwise, <see langword="false" />.</returns>
         <remarks>
           <format type="text/markdown">
             <![CDATA[
 
 ## Remarks
 
-If <xref:obj> is `null`, the method returns `false`.
+If `obj` is `null`, the method returns `false`.
 
             ]]>
           </format>
@@ -196,7 +196,7 @@ If <xref:obj> is `null`, the method returns `false`.
       <Docs>
         <param name="other">To be added.</param>
         <summary>Determines whether this instance and another specified <see cref="T:System.Text.Json.JsonEncodedText" /> instance have the same value.</summary>
-        <returns>To be added.</returns>
+        <returns><see langword="true" /> if this instance and <paramref name="other" /> have the same value; otherwise, <see langword="false" />.</returns>
         <remarks>
           <format type="text/markdown">
             <![CDATA[
@@ -228,14 +228,14 @@ Default instances of <xref:System.Text.Json.JsonEncodedText> are treated as equa
       <Parameters />
       <Docs>
         <summary>Returns the hash code for this <see cref="T:System.Text.Json.JsonEncodedText" />.</summary>
-        <returns>To be added.</returns>
+        <returns>The hash code for this instance.</returns>
         <remarks>
           <format type="text/markdown">
             <![CDATA[
 
 ## Remarks
 
-Returns 0 on a default instance of <xref:System.Text.Json.JsonEncodedText>.
+This method returns 0 on a default instance of <xref:System.Text.Json.JsonEncodedText>.
 
             ]]>
           </format>
@@ -260,19 +260,19 @@ Returns 0 on a default instance of <xref:System.Text.Json.JsonEncodedText>.
       <Parameters />
       <Docs>
         <summary>Converts the value of this instance to a <see cref="T:System.String" />.</summary>
-        <returns>Returns the underlying UTF-16 encoded string.</returns>
+        <returns>The underlying UTF-16 encoded string.</returns>
         <remarks>
           <format type="text/markdown">
             <![CDATA[
 
 ## Remarks
 
-Returns an empty string on a default instance of <xref:System.Text.Json.JsonEncodedText>.
+This method returns an empty string on a default instance of <xref:System.Text.Json.JsonEncodedText>.
 
             ]]>
           </format>
         </remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>