Fix Utf8JsonWriter WriteXValue methods documentation to remove array-specific language (#11476)

Author: Copilot

xml/System.Text.Json/Utf8JsonWriter.xml

@@ -781,8 +781,8 @@ The bytes are encoded before writing.
         <Parameter Name="bytes" Type="System.ReadOnlySpan&lt;System.Byte&gt;" />
       </Parameters>
       <Docs>
-        <param name="bytes">The binary data to be written as a Base64 encoded JSON string element of a JSON array.</param>
-        <summary>Writes the raw bytes value as a Base64 encoded JSON string as an element of a JSON array.</summary>
+        <param name="bytes">The binary data to be written as a Base64 encoded JSON string.</param>
+        <summary>Writes the raw bytes value as a Base64 encoded JSON string.</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[
 
@@ -996,8 +996,8 @@ The property name should already be escaped when the instance of <xref:System.Te
         <Parameter Name="value" Type="System.Boolean" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON literal <b>true</b> or <b>false</b> as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.Boolean" /> value (as a JSON literal <b>true</b> or <b>false</b>) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON literal <b>true</b> or <b>false</b>.</param>
+        <summary>Writes a <see cref="T:System.Boolean" /> value (as a JSON literal <b>true</b> or <b>false</b>).</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.InvalidOperationException">Validation is enabled, and the operation would result in writing invalid JSON.</exception>
       </Docs>
@@ -1381,7 +1381,7 @@ The property name should already be escaped when the instance of <xref:System.Te
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>Writes the JSON literal <b>null</b> as an element of a JSON array.</summary>
+        <summary>Writes the JSON literal <b>null</b>.</summary>
         <remarks>To be added.</remarks>
         <exception cref="T:System.InvalidOperationException">Validation is enabled, and the operation would result in writing invalid JSON.</exception>
       </Docs>
@@ -2720,8 +2720,8 @@ The property name should already be escaped when the instance of <xref:System.Te
         <Parameter Name="value" Type="System.Decimal" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON number as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.Decimal" /> value (as a JSON number) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON number.</param>
+        <summary>Writes a <see cref="T:System.Decimal" /> value (as a JSON number).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -2760,8 +2760,8 @@ This method writes the <xref:System.Decimal> value using the default <xref:Syste
         <Parameter Name="value" Type="System.Double" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON number as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.Double" /> value (as a JSON number) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON number.</param>
+        <summary>Writes a <see cref="T:System.Double" /> value (as a JSON number).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -2800,8 +2800,8 @@ This method writes the <xref:System.Double> value using the default <xref:System
         <Parameter Name="value" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON number as an element of a JSON array.</param>
-        <summary>Writes an <see cref="T:System.Int32" /> value (as a JSON number) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON number.</param>
+        <summary>Writes an <see cref="T:System.Int32" /> value (as a JSON number).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -2840,8 +2840,8 @@ This method writes the <xref:System.Int32> value using the default <xref:System.
         <Parameter Name="value" Type="System.Int64" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON number as an element of a JSON array.</param>
-        <summary>Writes an <see cref="T:System.Int64" /> value (as a JSON number) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON number.</param>
+        <summary>Writes an <see cref="T:System.Int64" /> value (as a JSON number).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -2880,8 +2880,8 @@ This method writes the <xref:System.Int64> value using the default <xref:System.
         <Parameter Name="value" Type="System.Single" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON number as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.Single" /> value (as a JSON number) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON number.</param>
+        <summary>Writes a <see cref="T:System.Single" /> value (as a JSON number).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -2926,8 +2926,8 @@ This method writes the <xref:System.Single> value using the default <xref:System
         <Parameter Name="value" Type="System.UInt32" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON number as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.UInt32" /> value (as a JSON number) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON number.</param>
+        <summary>Writes a <see cref="T:System.UInt32" /> value (as a JSON number).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -2972,8 +2972,8 @@ This method writes the <xref:System.UInt32> value using the default <xref:System
         <Parameter Name="value" Type="System.UInt64" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON number as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.UInt64" /> value (as a JSON number) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON number.</param>
+        <summary>Writes a <see cref="T:System.UInt64" /> value (as a JSON number).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -5093,8 +5093,8 @@ The property name and value should already be escaped when the instance of <xref
         <Parameter Name="value" Type="System.DateTime" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON string as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.DateTime" /> value (as a JSON string) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON string.</param>
+        <summary>Writes a <see cref="T:System.DateTime" /> value (as a JSON string).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -5134,8 +5134,8 @@ for example, 2017-06-12T05:30:45.7680000.
         <Parameter Name="value" Type="System.DateTimeOffset" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON string as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.DateTimeOffset" /> value (as a JSON string) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON string.</param>
+        <summary>Writes a <see cref="T:System.DateTimeOffset" /> value (as a JSON string).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -5174,8 +5174,8 @@ This method writes the <xref:System.DateTimeOffset> using the ISO 8601-1 extende
         <Parameter Name="value" Type="System.Guid" />
       </Parameters>
       <Docs>
-        <param name="value">The value to be written as a JSON string as an element of a JSON array.</param>
-        <summary>Writes a <see cref="T:System.Guid" /> value (as a JSON string) as an element of a JSON array.</summary>
+        <param name="value">The value to be written as a JSON string.</param>
+        <summary>Writes a <see cref="T:System.Guid" /> value (as a JSON string).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -5214,8 +5214,8 @@ This method writes the <xref:System.Guid> value using the default <xref:System.B
         <Parameter Name="utf8Value" Type="System.ReadOnlySpan&lt;System.Byte&gt;" />
       </Parameters>
       <Docs>
-        <param name="utf8Value">The UTF-8 encoded value to be written as a JSON string element of a JSON array.</param>
-        <summary>Writes a UTF-8 text value (as a JSON string) as an element of a JSON array.</summary>
+        <param name="utf8Value">The UTF-8 encoded value to be written as a JSON string.</param>
+        <summary>Writes a UTF-8 text value (as a JSON string).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -5255,8 +5255,8 @@ The value is escaped before writing.
         <Parameter Name="value" Type="System.ReadOnlySpan&lt;System.Char&gt;" />
       </Parameters>
       <Docs>
-        <param name="value">The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string element of a JSON array.</param>
-        <summary>Writes a UTF-16 text value (as a JSON string) as an element of a JSON array.</summary>
+        <param name="value">The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string.</param>
+        <summary>Writes a UTF-16 text value (as a JSON string).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -5297,8 +5297,8 @@ The value is escaped before writing.
         <Parameter Name="value" Type="System.String" />
       </Parameters>
       <Docs>
-        <param name="value">The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string element of a JSON array.</param>
-        <summary>Writes a string text value (as a JSON string) as an element of a JSON array.</summary>
+        <param name="value">The UTF-16 encoded value to be written as a UTF-8 transcoded JSON string.</param>
+        <summary>Writes a string text value (as a JSON string).</summary>
         <remarks>
           <format><![CDATA[
 
@@ -5340,8 +5340,8 @@ If `value` is `null`, the JSON **null** value is written, as if the <xref:System
         <Parameter Name="value" Type="System.Text.Json.JsonEncodedText" />
       </Parameters>
       <Docs>
-        <param name="value">The JSON encoded value to be written as a UTF-8 transcoded JSON string element of a JSON array.</param>
-        <summary>Writes the pre-encoded text value (as a JSON string) as an element of a JSON array.</summary>
+        <param name="value">The JSON encoded value to be written as a UTF-8 transcoded JSON string.</param>
+        <summary>Writes the pre-encoded text value (as a JSON string).</summary>
         <remarks>
           <format type="text/markdown"><![CDATA[