Update JsonException.xml

Author: Ron Petrusha

xml/System.Text.Json/JsonException.xml

@@ -1,4 +1,5 @@
-<Type Name="JsonException" FullName="System.Text.Json.JsonException"><TypeSignature Language="C#" Value="public class JsonException : Exception" />
+<Type Name="JsonException" FullName="System.Text.Json.JsonException">
+  <TypeSignature Language="C#" Value="public class JsonException : Exception" />
   <TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit JsonException extends System.Exception" />
   <TypeSignature Language="DocId" Value="T:System.Text.Json.JsonException" />
   <TypeSignature Language="VB.NET" Value="Public Class JsonException&#xA;Inherits Exception" />
@@ -34,11 +35,11 @@
         <Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
       </Parameters>
       <Docs>
-        <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that holds the serialized object data about the exception being thrown.</param>
-        <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext" /> that contains contextual information about the source or destination.</param>
+        <param name="info">The serialized object data about the exception being thrown.</param>
+        <param name="context">An object that contains contextual information about the source or destination.</param>
         <summary>Creates a new exception object with serialized data.</summary>
         <remarks>To be added.</remarks>
-        <exception cref="T:System.ArgumentNullException">Thrown when <paramref name="info" /> is <see langword="null" />.</exception>
+        <exception cref="T:System.ArgumentNullException"><paramref name="info" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName=".ctor">
@@ -60,18 +61,18 @@
         <Parameter Name="bytePositionInLine" Type="System.Nullable&lt;System.Int64&gt;" />
       </Parameters>
       <Docs>
-        <param name="message">The context specific error message.</param>
+        <param name="message">The context-specific error message.</param>
         <param name="path">The path where the invalid JSON was encountered.</param>
-        <param name="lineNumber">The line number at which the invalid JSON was encountered (starting at 0) when deserializing.</param>
-        <param name="bytePositionInLine">The byte count within the current line where the invalid JSON was encountered (starting at 0).</param>
+        <param name="lineNumber">The line number (starting at 0) at which the invalid JSON was encountered when deserializing.</param>
+        <param name="bytePositionInLine">The byte count within the current line (starting at 0) where the invalid JSON was encountered.</param>
         <summary>Creates a new exception object to relay error information to the user.</summary>
         <remarks>
           <format type="text/markdown">
             <![CDATA[
 
 ## Remarks
 
-Note that the <xref:bytePositionInLine> counts the number of bytes (i.e. UTF-8 code units) and not characters or scalars.
+Note that `bytePositionInLine` counts the number of bytes (that is,  UTF-8 code units), and not characters or scalars.
 
             ]]>
           </format>
@@ -98,19 +99,19 @@ Note that the <xref:bytePositionInLine> counts the number of bytes (i.e. UTF-8 c
         <Parameter Name="innerException" Type="System.Exception" />
       </Parameters>
       <Docs>
-        <param name="message">The context specific error message.</param>
+        <param name="message">The context-specific error message.</param>
         <param name="path">The path where the invalid JSON was encountered.</param>
-        <param name="lineNumber">The line number at which the invalid JSON was encountered (starting at 0) when deserializing.</param>
-        <param name="bytePositionInLine">The byte count within the current line where the invalid JSON was encountered (starting at 0).</param>
+        <param name="lineNumber">The line number (starting at 0) at which the invalid JSON was encountered when deserializing.</param>
+        <param name="bytePositionInLine">The byte count (starting at 0) within the current line where the invalid JSON was encountered.</param>
         <param name="innerException">The exception that caused the current exception.</param>
-        <summary>Creates a new exception object to relay error information to the user.</summary>
+        <summary>Creates a new exception object to relay error information to the user that includes a specified inner exception.</summary>
         <remarks>
           <format type="text/markdown">
             <![CDATA[
 
 ## Remarks
 
-Note that the <xref:bytePositionInLine> counts the number of bytes (i.e. UTF-8 code units) and not characters or scalars.
+Note that the `bytePositionInLine` counts the number of bytes (that is, UTF-8 code units), and not characters or scalars.
 
             ]]>
           </format>
@@ -133,8 +134,8 @@ Note that the <xref:bytePositionInLine> counts the number of bytes (i.e. UTF-8 c
         <ReturnType>System.Nullable&lt;System.Int64&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The number of bytes read within the current line before the exception (starting at 0).</summary>
-        <value>To be added.</value>
+        <summary>Gets the zero-based number of bytes read within the current line before the exception.</summary>
+        <value>The zero-based number of bytes read within the current line before the exception.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -158,8 +159,8 @@ Note that the <xref:bytePositionInLine> counts the number of bytes (i.e. UTF-8 c
         <Parameter Name="context" Type="System.Runtime.Serialization.StreamingContext" />
       </Parameters>
       <Docs>
-        <param name="info">The <see cref="T:System.Runtime.Serialization.SerializationInfo" /> that holds the serialized object data about the exception being thrown.</param>
-        <param name="context">The <see cref="T:System.Runtime.Serialization.StreamingContext" /> that contains contextual information about the source or destination.</param>
+        <param name="info">The serialized object data about the exception being thrown.</param>
+        <param name="context">An object that contains contextual information about the source or destination.</param>
         <summary>Sets the <see cref="T:System.Runtime.Serialization.SerializationInfo" /> with information about the exception.</summary>
         <remarks>To be added.</remarks>
       </Docs>
@@ -180,8 +181,8 @@ Note that the <xref:bytePositionInLine> counts the number of bytes (i.e. UTF-8 c
         <ReturnType>System.Nullable&lt;System.Int64&gt;</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The number of lines read so far before the exception (starting at 0).</summary>
-        <value>To be added.</value>
+        <summary>Gets the zero-based number of lines read before the exception.</summary>
+        <value>The zero-based number of lines read before the exception.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -201,10 +202,10 @@ Note that the <xref:bytePositionInLine> counts the number of bytes (i.e. UTF-8 c
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>The path within the JSON where the exception was encountered.</summary>
-        <value>To be added.</value>
+        <summary>Gets The path within the JSON where the exception was encountered.</summary>
+        <value>The path within the JSON where the exception was encountered.</value>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
   </Members>
-</Type>
+</Type>