Fix XML formatting: use 2-space indentation, add line breaks for long content, and add para tags for semantic paragraphs

Co-authored-by: jeffhandley <[email protected]>

Author: Copilot

xml/System.Collections.Concurrent/ConcurrentDictionary`2+AlternateLookup`1.xml

@@ -128,7 +128,7 @@
         <param name="key">The alternate key of the value to get or set.</param>
         <summary>Gets or sets the value associated with the specified alternate key.</summary>
         <value>
-            The value associated with the specified alternate key. If the specified alternate key is not found, a get operation throws a <see cref="T:System.Collections.Generic.KeyNotFoundException" />, and a set operation creates a new element with the specified key.
+          The value associated with the specified alternate key. If the specified alternate key is not found, a get operation throws a <see cref="T:System.Collections.Generic.KeyNotFoundException" />, and a set operation creates a new element with the specified key.
         </value>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentNullException">
@@ -243,11 +243,11 @@
       <Docs>
         <param name="key">The alternate key of the value to get.</param>
         <param name="actualKey">
-            When this method returns, contains the actual key associated with the alternate key, if the key is found;
-            otherwise, the default value for the type of the key parameter.
+          When this method returns, contains the actual key associated with the alternate key, if the key is found;
+          otherwise, the default value for the type of the key parameter.
         </param>
         <param name="value">
-            When this method returns, contains the value associated with the specified key, if the key is found; otherwise, the default value for the type of the value parameter.
+          When this method returns, contains the value associated with the specified key, if the key is found; otherwise, the default value for the type of the value parameter.
         </param>
         <summary>Gets the value associated with the specified alternate key.</summary>
         <returns>
@@ -287,7 +287,11 @@
       <Docs>
         <param name="key">The alternate key of the element to remove.</param>
         <param name="value">The removed element.</param>
-        <summary>Removes the value with the specified alternate key from the <see cref="T:System.Collections.Generic.Dictionary`2" />, and copies the element to the value parameter.</summary>
+        <summary>
+          Removes the value with the specified alternate key from the
+          <see cref="T:System.Collections.Generic.Dictionary`2" />,
+          and copies the element to the value parameter.
+        </summary>
         <returns>
           <see langword="true" /> if the element is successfully found and removed; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
@@ -335,8 +339,8 @@
         <param name="actualKey">The removed key.</param>
         <param name="value">The removed element.</param>
         <summary>
-            Removes the value with the specified alternate key from the <see cref="T:System.Collections.Generic.Dictionary`2" />,
-            and copies the associated key and element to the value parameter.
+          Removes the value with the specified alternate key from the <see cref="T:System.Collections.Generic.Dictionary`2" />,
+          and copies the associated key and element to the value parameter.
         </summary>
         <returns>
           <see langword="true" /> if the element is successfully found and removed; otherwise, <see langword="false" />.</returns>

xml/System.Collections.Frozen/FrozenDictionary`2+AlternateLookup`1.xml

@@ -45,7 +45,10 @@
     <typeparam name="TValue">The type of the values in the dictionary.</typeparam>
     <typeparam name="TAlternateKey">The alternate type of a key for performing lookups.</typeparam>
     <summary>
-      Provides a type that may be used to perform operations on a <see cref="T:System.Collections.Frozen.FrozenDictionary`2" /> using a <typeparamref name="TAlternateKey" /> as a key instead of a <typeparamref name="TKey" />.
+      Provides a type that may be used to perform operations on a
+      <see cref="T:System.Collections.Frozen.FrozenDictionary`2" />
+      using a <typeparamref name="TAlternateKey" /> as a key
+      instead of a <typeparamref name="TKey" />.
     </summary>
     <remarks>To be added.</remarks>
   </Docs>

xml/System.Collections.Frozen/FrozenDictionary`2.xml

@@ -294,7 +294,12 @@
           Gets an instance of a type that may be used to perform operations on a <see cref="T:System.Collections.Frozen.FrozenDictionary`2" /> using a <typeparamref name="TAlternateKey" /> as a key instead of a <typeparamref name="TKey" />.
         </summary>
         <returns>The created lookup instance.</returns>
-        <remarks>This instance must be using a comparer that implements <see cref="T:System.Collections.Generic.IAlternateEqualityComparer`2" /> with <typeparamref name="TAlternateKey" /> and <typeparamref name="TKey" />. If it doesn't, an exception will be thrown.</remarks>
+        <remarks>
+          This instance must be using a comparer that implements
+          <see cref="T:System.Collections.Generic.IAlternateEqualityComparer`2" />
+          with <typeparamref name="TAlternateKey" /> and <typeparamref name="TKey" />.
+          If it doesn't, an exception will be thrown.
+        </remarks>
         <exception cref="T:System.InvalidOperationException">This instance's comparer is not compatible with <typeparamref name="TAlternateKey" />.</exception>
       </Docs>
     </Member>

xml/System.Text.Json/JsonSerializer.xml

@@ -382,11 +382,30 @@ There is remaining data in the string beyond a single JSON value.</exception>
         <summary>Reads one JSON value (including objects or arrays) from the provided reader into an instance specified by the <paramref name="jsonTypeInfo" />.</summary>
         <returns>A <paramref name="jsonTypeInfo" /> representation of the JSON value.</returns>
         <remarks>
-            If the <see cref="P:System.Text.Json.Utf8JsonReader.TokenType" /> property of <paramref name="reader" /> is <see cref="F:System.Text.Json.JsonTokenType.PropertyName" /> or <see cref="F:System.Text.Json.JsonTokenType.None" />, the reader will be advanced by one call to <see cref="M:System.Text.Json.Utf8JsonReader.Read" /> to determine the start of the value.
-            Upon completion of this method, <paramref name="reader" /> will be positioned at the final token in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the method was called.
-            This method makes a copy of the data the reader acted on, so there is no caller requirement to maintain data integrity beyond the return of this method.
-            The <see cref="T:System.Text.Json.JsonReaderOptions" /> used to create the instance of the <see cref="T:System.Text.Json.Utf8JsonReader" /> take precedence over the <see cref="T:System.Text.Json.JsonSerializerOptions" /> when they conflict.
-            Hence, <see cref="P:System.Text.Json.JsonReaderOptions.AllowTrailingCommas" />, <see cref="P:System.Text.Json.JsonReaderOptions.MaxDepth" />, and <see cref="P:System.Text.Json.JsonReaderOptions.CommentHandling" /> are used while reading.
+          <para>
+            If the <see cref="P:System.Text.Json.Utf8JsonReader.TokenType" /> property of
+            <paramref name="reader" /> is <see cref="F:System.Text.Json.JsonTokenType.PropertyName" />
+            or <see cref="F:System.Text.Json.JsonTokenType.None" />, the reader will be advanced by one
+            call to <see cref="M:System.Text.Json.Utf8JsonReader.Read" /> to determine the start of the value.
+          </para>
+          <para>
+            Upon completion of this method, <paramref name="reader" /> will be positioned at the final token
+            in the JSON value. If an exception is thrown, the reader is reset to the state it was in when the
+            method was called.
+          </para>
+          <para>
+            This method makes a copy of the data the reader acted on, so there is no caller requirement to
+            maintain data integrity beyond the return of this method.
+          </para>
+          <para>
+            The <see cref="T:System.Text.Json.JsonReaderOptions" /> used to create the instance of the
+            <see cref="T:System.Text.Json.Utf8JsonReader" /> take precedence over the
+            <see cref="T:System.Text.Json.JsonSerializerOptions" /> when they conflict.
+            Hence, <see cref="P:System.Text.Json.JsonReaderOptions.AllowTrailingCommas" />,
+            <see cref="P:System.Text.Json.JsonReaderOptions.MaxDepth" />, and
+            <see cref="P:System.Text.Json.JsonReaderOptions.CommentHandling" /> are used
+            while reading.
+          </para>
         </remarks>
         <exception cref="T:System.Text.Json.JsonException">The JSON is invalid,
              <paramref name="jsonTypeInfo" /> is not compatible with the JSON,