suggestions by ahsonkhan

Co-Authored-By: Ahson Khan <[email protected]>

Author: carlossanlop

xml/System.Text.Json.Serialization/JsonAttribute.xml

@@ -31,7 +31,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>Creates a new instance of the <see cref="T:System.Text.Json.Serialization.JsonAttribute" /> instance.</summary>
+        <summary>Creates a new instance of the <see cref="T:System.Text.Json.Serialization.JsonAttribute" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Text.Json.Serialization/JsonExtensionDataAttribute.xml

@@ -19,7 +19,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>When placed on a property of type <see cref="T:System.Collections.Generic.IDictionary`2" />, provides that any properties that do not have a matching member are added to that dictionary during deserialization and written during serialization.</summary>
+    <summary>When placed on a property of type <see cref="T:System.Collections.Generic.IDictionary`2" />, any properties that do not have a matching member are added to that dictionary during deserialization and written during serialization.</summary>
     <remarks>
       <format type="text/markdown">
             <![CDATA[
@@ -32,7 +32,7 @@ During deserialization, when using <xref:System.Object>, a "null" JSON value is
             
 During serialization, the name of the extension data property is not included in the JSON; the data contained within the extension data is serialized as properties of the JSON object.
             
-If there is more than one extension property on a type, or it the property is not of the correct type, an <xref:System.InvalidOperationException> is thrown during the first serialization or deserialization of that type.
+If there is more than one property on a type with this extension data attribute, or if the property itself is not of the correct <see cref="T:System.Collections.Generic.IDictionary`2" /> type, an <xref:System.InvalidOperationException> is thrown during the first serialization or deserialization of that type.
 
             ]]>
           </format>

xml/System.Text.Json/JsonTokenType.xml

@@ -34,7 +34,7 @@
       </ReturnValue>
       <MemberValue>11</MemberValue>
       <Docs>
-        <summary>The token type is the comment string.</summary>
+        <summary>The token type is a comment string.</summary>
       </Docs>
     </Member>
     <Member MemberName="EndArray">
@@ -94,7 +94,7 @@
       </ReturnValue>
       <MemberValue>9</MemberValue>
       <Docs>
-        <summary>The token type is the JSON literal <see langword="false" />.</summary>
+        <summary>The token type is the JSON literal "false".</summary>
       </Docs>
     </Member>
     <Member MemberName="None">
@@ -145,7 +145,7 @@ This is the default token type if no data has been read by the <xref:System.Text
       </ReturnValue>
       <MemberValue>10</MemberValue>
       <Docs>
-        <summary>The token type is the JSON literal <see langword="null" />.</summary>
+        <summary>The token type is the JSON literal "null".</summary>
       </Docs>
     </Member>
     <Member MemberName="Number">

xml/System.Text.Json/Utf8JsonReader.xml

@@ -273,9 +273,9 @@ The JSON string is incomplete; that is, the JSON string length is not a multiple
       <Parameters />
       <Docs>
         <summary>Parses the current JSON token value from the source as a comment, transcoded it as a <see cref="T:System.String" />.</summary>
-        <returns>The comment that represnets the current JSON token value.</returns>
+        <returns>The comment that represents the current JSON token value.</returns>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.InvalidOperationException">The JSON token that is not a comment.</exception>
+        <exception cref="T:System.InvalidOperationException">The JSON token is not a comment.</exception>
       </Docs>
     </Member>
     <Member MemberName="GetDateTime">
@@ -667,8 +667,8 @@ For input data within a `ReadOnlySpan<byte>`, this always returns `false`. For i
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the mode of this instance of the <see cref="T:System.Text.Json.Utf8JsonReader" />.</summary>
-        <value><see langword="true" /> if the reader was constructed with the input span containing the entire data to process. <see langword="false" /> if the reader was constructed with an input span that may contain partial data with more data to follow.</value>
+        <summary>Gets the mode of this instance of the <see cref="T:System.Text.Json.Utf8JsonReader" /> which indicates whether all the JSON data was provided or there is more data to come.</summary>
+        <value><see langword="true" /> if the reader was constructed with the input span or sequence containing the entire JSON data to process. <see langword="false" /> if the reader was constructed with an input span or sequence that may contain partial JSON data with more data to follow.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -844,7 +844,7 @@ If the look up text is invalid or incomplete UTF-16 text (such as unpaired surro
         <ReturnType>System.Int64</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>Gets the index that the last processed JSON token within the given UTF-8 encoded input text starts at, skipping any white space.</summary>
+        <summary>Gets the index that the last processed JSON token starts at (within the given UTF-8 encoded input text), skipping any white space.</summary>
         <value>The starting index of the last processed JSON token within the given UTF-8 encoded input text.</value>
         <remarks>
           <format type="text/markdown">
@@ -901,7 +901,7 @@ For comments, this value points to before the first comment delimiter (that is,
         <Parameter Name="value" Type="System.Byte[]" RefType="out" />
       </Parameters>
       <Docs>
-        <param name="value">When the method returns, a byte array that contains the base 64-encoded JSON string if the method succeeds.</param>
+        <param name="value">If the method succeeds, a byte array that contains the base 64-encoded JSON string.</param>
         <summary>Tries to parse the current JSON token value from the source and decodes the base 64 encoded JSON string as a byte array.</summary>
         <returns><see langword="true" /> if the entire token value is encoded as valid base 64 text and can be successfully decoded; <see langword="false" /> otherwise.</returns>
         <remarks>To be added.</remarks>