Update baselines for mdoc 5.8.9 (#7995)

Author: gewarren

xml/System.Collections.Immutable/ImmutableArray.xml

@@ -973,7 +973,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
         <TypeParameter Name="T" />
       </TypeParameters>
       <Parameters>
-        <Parameter Name="items" Type="System.ReadOnlySpan&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" RefType="this" />
+        <Parameter Name="items" Type="System.ReadOnlySpan&lt;T&gt;" RefType="this" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
         <typeparam name="T">The type of element in the list.</typeparam>
@@ -1002,7 +1002,7 @@ This overload allows helper methods or custom builder classes to efficiently avo
         <TypeParameter Name="T" />
       </TypeParameters>
       <Parameters>
-        <Parameter Name="items" Type="System.Span&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" RefType="this" />
+        <Parameter Name="items" Type="System.Span&lt;T&gt;" RefType="this" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
         <typeparam name="T">The type of element in the list.</typeparam>

xml/System.CommandLine.Builder/CommandLineBuilderExtensions.xml

@@ -40,9 +40,9 @@
         <Parameter Name="order" Type="System.CommandLine.Invocation.MiddlewareOrder" />
       </Parameters>
       <Docs>
+        <param name="builder">A command line builder.</param>
         <param name="onInvoke">A delegate that will be invoked before a call to a command handler.</param>
         <param name="order">A value indicating the order in which the added delegate will be invoked relative to others in the pipeline.</param>
-        <param name="builder">A command line builder.</param>
         <summary>
             Adds a middleware delegate to the invocation pipeline called before a command handler is invoked.
             </summary>
@@ -225,8 +225,8 @@
         <Parameter Name="responseFileHandling" Type="System.CommandLine.Parsing.ResponseFileHandling" />
       </Parameters>
       <Docs>
-        <param name="responseFileHandling">Specifies whether or how response files are parsed.</param>
         <param name="builder">A command line builder.</param>
+        <param name="responseFileHandling">Specifies whether or how response files are parsed.</param>
         <summary>To be added.</summary>
         <returns>The same instance of <see cref="T:System.CommandLine.Builder.CommandLineBuilder" />.</returns>
         <remarks>To be added.</remarks>
@@ -570,8 +570,8 @@
         <Parameter Name="errorExitCode" Type="System.Nullable&lt;System.Int32&gt;" />
       </Parameters>
       <Docs>
-        <param name="errorExitCode">The exit code to use when parser errors occur.</param>
         <param name="builder">A command line builder.</param>
+        <param name="errorExitCode">The exit code to use when parser errors occur.</param>
         <summary>
             Configures the command line to write error information to standard error when there are errors parsing command line input.
             </summary>
@@ -688,8 +688,8 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="aliases">One or more aliases to use instead of the default to signal that version information should be displayed.</param>
         <param name="builder">A command line builder.</param>
+        <param name="aliases">One or more aliases to use instead of the default to signal that version information should be displayed.</param>
         <summary>To be added.</summary>
         <returns>To be added.</returns>
         <remarks>To be added.</remarks>

xml/System.Data.Common/DbBatch.xml

@@ -493,7 +493,7 @@ The precise semantics of batch execution vary across ADO.NET providers, especial
         <Parameter Name="cancellationToken" Type="System.Threading.CancellationToken" />
       </Parameters>
       <Docs>
-        <param name="behavior">One of the enumeration values that specifies options for batch execution and data retrieval.</param>
+        <param name="cancellationToken">To be added.</param>
         <summary>An asynchronous version of <see cref="Overload:System.Data.Common.DbBatch.ExecuteReader" />, which executes the batch against its connection, returning a <see cref="T:System.Data.Common.DbDataReader" /> which can be used to access the results.</summary>
         <returns>A task representing the asynchronous operation.</returns>
         <remarks>

xml/System.Data.Common/DbBatchCommandCollection.xml

@@ -79,7 +79,7 @@
         <Parameter Name="item" Type="System.Data.Common.DbBatchCommand" />
       </Parameters>
       <Docs>
-        <param name="value">The <see cref="P:System.Data.Common.DbBatchCommand" /> to add to the collection.</param>
+        <param name="item">To be added.</param>
         <summary>Adds the specified <see cref="T:System.Data.Common.DbBatchCommand" /> object to the <see cref="T:System.Data.Common.DbBatchCommandCollection" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
@@ -132,7 +132,7 @@
         <Parameter Name="item" Type="System.Data.Common.DbBatchCommand" />
       </Parameters>
       <Docs>
-        <param name="value">The <see cref="P:System.Data.Common.DbBatchCommand" /> to look for in the collection.</param>
+        <param name="item">To be added.</param>
         <summary>Indicates whether a <see cref="T:System.Data.Common.DbBatchCommand" /> is contained in the collection.</summary>
         <returns>
           <see langword="true" /> if the <see cref="T:System.Data.Common.DbBatchCommand" /> is in the collection; otherwise <see langword="false" />.</returns>
@@ -241,7 +241,6 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <param name="index">The index of the <see cref="T:System.Data.Common.DbBatchCommand" /> in the collection.</param>
         <summary>Returns the <see cref="T:System.Data.Common.DbBatchCommand" /> object at the specified index in the collection.</summary>
         <returns>The <see cref="T:System.Data.Common.DbBatchCommand" /> object at the specified index in the collection.</returns>
         <remarks>To be added.</remarks>
@@ -270,7 +269,7 @@
         <Parameter Name="item" Type="System.Data.Common.DbBatchCommand" />
       </Parameters>
       <Docs>
-        <param name="value">The <see cref="T:System.Data.Common.DbBatchCommand" /> object in the collection.</param>
+        <param name="item">To be added.</param>
         <summary>Returns the index of the specified <see cref="T:System.Data.Common.DbBatchCommand" /> object.</summary>
         <returns>The index of the specified <see cref="T:System.Data.Common.DbBatchCommand" /> object.</returns>
         <remarks>To be added.</remarks>
@@ -301,7 +300,7 @@
       </Parameters>
       <Docs>
         <param name="index">The index at which to insert the <see cref="T:System.Data.Common.DbBatchCommand" /> object.</param>
-        <param name="value">The <see cref="T:System.Data.Common.DbBatchCommand" /> object to insert into the collection.</param>
+        <param name="item">To be added.</param>
         <summary>Inserts the specified index of the <see cref="T:System.Data.Common.DbBatchCommand" /> object with the specified name into the collection at the specified index.</summary>
         <remarks>To be added.</remarks>
       </Docs>
@@ -385,7 +384,7 @@
         <Parameter Name="item" Type="System.Data.Common.DbBatchCommand" />
       </Parameters>
       <Docs>
-        <param name="value">The <see cref="T:System.Data.Common.DbBatchCommand" /> object to remove.</param>
+        <param name="item">To be added.</param>
         <summary>Removes the specified <see cref="T:System.Data.Common.DbBatchCommand" /> object from the collection.</summary>
         <returns>
           <see langword="true" /> if <paramref name="item" /> was successfully removed; otherwise, <see langword="false" />. This method also returns <see langword="false" /> if <paramref name="item" /> was not found in the <see cref="T:System.Data.Common.DbBatchCommandCollection" />.
@@ -443,7 +442,7 @@
       </Parameters>
       <Docs>
         <param name="index">The index where the <see cref="T:System.Data.Common.DbBatchCommand" /> object is located.</param>
-        <param name="value">The new <see cref="T:System.Data.Common.DbBatchCommand" /> value.</param>
+        <param name="batchCommand">To be added.</param>
         <summary>Sets the <see cref="T:System.Data.Common.DbBatchCommand" /> object at the specified index to a new value.</summary>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.IO.Compression/BrotliDecoder.xml

@@ -71,19 +71,11 @@
         <param name="bytesWritten">The total number of bytes that were written in the <paramref name="destination" />.</param>
         <summary>Decompresses data that was compressed using the Brotli algorithm.</summary>
         <returns>One of the enumeration values that indicates the status of the decompression operation.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
-
-The return value can be as follows:
-- <xref:System.Buffers.OperationStatus.Done?displayProperty=nameWithType>: `source` was successfully and completely decompressed into `destination`.
-- <xref:System.Buffers.OperationStatus.DestinationTooSmall?displayProperty=nameWithType>: There is not enough space in `destination` to decompress `source`.
-- <xref:System.Buffers.OperationStatus.NeedMoreData?displayProperty=nameWithType>: The decompression action is partially done at least one more byte is required to complete the decompression task. This method should be called again with more input to decompress.
-- <xref:System.Buffers.OperationStatus.InvalidData?displayProperty=nameWithType>: The data in `source` is invalid and could not be decompressed.
-
-           ]]></format>
-        </remarks>
+        <remarks>The return value can be as follows:
+            - <see cref="F:System.Buffers.OperationStatus.Done" />: <paramref name="source" /> was successfully and completely decompressed into <paramref name="destination" />.
+            - <see cref="F:System.Buffers.OperationStatus.DestinationTooSmall" />: There is not enough space in <paramref name="destination" /> to decompress <paramref name="source" />.
+            - <see cref="F:System.Buffers.OperationStatus.NeedMoreData" />: The decompression action is partially done at least one more byte is required to complete the decompression task. This method should be called again with more input to decompress.
+            - <see cref="F:System.Buffers.OperationStatus.InvalidData" />: The data in <paramref name="source" /> is invalid and could not be decompressed.</remarks>
       </Docs>
     </Member>
     <Member MemberName="Dispose">
@@ -153,15 +145,7 @@ The return value can be as follows:
         <summary>Attempts to decompress data that was compressed with the Brotli algorithm.</summary>
         <returns>
           <see langword="true" /> on success; <see langword="false" /> otherwise.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
-
-If this method returns `false`, `destination` may be empty or contain partially decompressed data, with `bytesWritten` being zero or greater than zero but less than the expected total.
-
-           ]]></format>
-        </remarks>
+        <remarks>If this method returns <see langword="false" />, <paramref name="destination" /> may be empty or contain partially decompressed data, with <paramref name="bytesWritten" /> being zero or greater than zero but less than the expected total.</remarks>
       </Docs>
     </Member>
   </Members>

xml/System.IO.Compression/BrotliEncoder.xml

@@ -66,11 +66,8 @@
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="quality" /> is not between the minimum value of 0 and the maximum value of 11.
-
--or-
-
-<paramref name="window" /> is not between the minimum value of 10 and the maximum value of 24.
-        </exception>
+            -or-
+            <paramref name="window" /> is not between the minimum value of 10 and the maximum value of 24.</exception>
         <exception cref="T:System.IO.IOException">Failed to create the <see cref="T:System.IO.Compression.BrotliEncoder" /> instance.</exception>
       </Docs>
     </Member>
@@ -213,15 +210,7 @@
         <param name="inputSize">The input size to get the maximum expected compressed length from. Must be greater or equal than 0 and less or equal than <see cref="F:System.Int32.MaxValue" /> - 515.</param>
         <summary>Gets the maximum expected compressed length for the provided input size.</summary>
         <returns>A number representing the maximum compressed length for the provided input size.</returns>
-        <remarks>
-          <format type="text/markdown"><![CDATA[
-
-## Remarks
-
-Returns 1 if `inputSize` is 0.
-
-          ]]></format>
-        </remarks>
+        <remarks>Returns 1 if <paramref name="inputSize" /> is 0.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="inputSize" /> is less than 0, the minimum allowed input size, or greater than <see cref="F:System.Int32.MaxValue" /> - 515, the maximum allowed input size.</exception>
       </Docs>