Port documentation for .NET 7.0 Preview2 (#7889)

* Microsoft.Extensions.DiagnosticAdapter.Internal

* Microsoft.Extensions.Logging.AzureAppServices.Internal

* Microsoft.Extensions.Logging.Console

* Microsoft.Extensions.Logging.Filter.Internal

* Microsoft.Extensions.Logging.TraceSource

* Microsoft.Extensions.Primitives

* System

* System.Collections.Concurrent

* System.Collections.Immutable

* System.Collections.Specialized

* System.ComponentModel.Composition.ReflectionModel

* System.ComponentModel.Design.Serialization

* System.Data.SqlTypes

* System.Diagnostics

* System.Diagnostics.CodeAnalysis

* System.Diagnostics.Metrics

* System.Drawing

* System.IO

* System.IO.Compression

* System.Linq

* System.Net.Sockets

* System.Reflection

* System.Runtime.CompilerServices

* System.Runtime.InteropServices

* System.Runtime.Intrinsics.Arm

* System.Security.Cryptography

* System.Security.Cryptography.Cose

* System.Text.RegularExpressions

* System.Transactions

* System.Web.DynamicData

* Suggestions by gewarren

Co-authored-by: Genevieve Warren <[email protected]>

* suggestions by gewarren

Co-authored-by: Genevieve Warren <[email protected]>

* Apply suggestions from code review

* Update xml/System.Diagnostics.Metrics/ObservableUpDownCounter`1.xml

Co-authored-by: carlossanlop <[email protected]>
Co-authored-by: Genevieve Warren <[email protected]>

Author: carlossanlop

xml/Microsoft.Extensions.DiagnosticAdapter.Internal/ProxyBase.xml

@@ -111,7 +111,7 @@
       </TypeParameters>
       <Parameters />
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
+        <typeparam name="T">The type of the underlying object.</typeparam>
         <summary>Unwraps the underlying object and performs a cast to <typeparamref name="T" />.</summary>
         <returns>The underlying object.</returns>
         <remarks>To be added.</remarks>

xml/Microsoft.Extensions.DiagnosticAdapter.Internal/ProxyFactory.xml

@@ -82,7 +82,7 @@
         <Parameter Name="obj" Type="System.Object" />
       </Parameters>
       <Docs>
-        <typeparam name="TProxy">To be added.</typeparam>
+        <typeparam name="TProxy">The type of the proxy to create.</typeparam>
         <param name="obj">The object to wrap in a proxy.</param>
         <summary>Creates a proxy object that is assignable to type <typeparamref name="TProxy" />.</summary>
         <returns>A proxy object, or <paramref name="obj" /> if a proxy is not needed.</returns>

xml/Microsoft.Extensions.Logging.AzureAppServices.Internal/BatchingLogger.xml

@@ -76,7 +76,7 @@
         <Parameter Name="state" Type="TState" />
       </Parameters>
       <Docs>
-        <typeparam name="TState">To be added.</typeparam>
+        <typeparam name="TState">The type of the state to begin scope for.</typeparam>
         <param name="state">The identifier for the scope.</param>
         <summary>Begins a logical operation scope.</summary>
         <returns>A disposable object that ends the logical operation scope on dispose.</returns>

xml/Microsoft.Extensions.Logging.Console/ConsoleLogger.xml

@@ -116,7 +116,7 @@
         <Parameter Name="state" Type="TState" />
       </Parameters>
       <Docs>
-        <typeparam name="TState">To be added.</typeparam>
+        <typeparam name="TState">The type of the state to begin scope for.</typeparam>
         <param name="state">The identifier for the scope.</param>
         <summary>Begins a logical operation scope.</summary>
         <returns>A disposable object that ends the logical operation scope on dispose.</returns>

xml/Microsoft.Extensions.Logging.Filter.Internal/FilterLogger.xml

@@ -75,7 +75,7 @@
         <Parameter Name="state" Type="TState" />
       </Parameters>
       <Docs>
-        <typeparam name="TState">To be added.</typeparam>
+        <typeparam name="TState">The type of the state to begin scope for.</typeparam>
         <param name="state">The identifier for the scope.</param>
         <summary>Begins a logical operation scope.</summary>
         <returns>An <see cref="T:System.IDisposable" /> that ends the logical operation scope on dispose.</returns>

xml/Microsoft.Extensions.Logging.TraceSource/TraceSourceLogger.xml

@@ -86,7 +86,7 @@
         <Parameter Name="state" Type="TState" />
       </Parameters>
       <Docs>
-        <typeparam name="TState">To be added.</typeparam>
+        <typeparam name="TState">The type of the state to begin scope for.</typeparam>
         <param name="state">The identifier for the scope.</param>
         <summary>Begins a logical operation scope.</summary>
         <returns>A disposable object that ends the logical operation scope on dispose.</returns>

xml/Microsoft.Extensions.Primitives/StringSegment.xml

@@ -442,11 +442,11 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <param name="obj">To be added.</param>
+        <param name="obj">An object to compare with this object.</param>
         <summary>Indicates whether the current object is equal to another object of the same type.</summary>
-        <returns>To be added.</returns>
+        <returns>
+          <see langword="true" /> if the current object is equal to <paramref name="obj" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
-        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="Equals">

xml/System.Collections.Concurrent/BlockingCollection`1.xml

@@ -1404,6 +1404,7 @@ This member is an explicit interface member implementation. It can be used only
         </remarks>
         <exception cref="T:System.ObjectDisposedException">The <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> has been disposed.</exception>
         <exception cref="T:System.InvalidOperationException">The underlying collection was modified outside of this <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> instance, or the <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> is empty and the collection has been marked as complete for adding.</exception>
+        <exception cref="T:System.OperationCanceledException">The <see cref="T:System.Collections.Concurrent.BlockingCollection`1" /> is empty and has been marked as complete with regards to additions.</exception>
         <related type="Article" href="/dotnet/standard/collections/thread-safe/">Thread-Safe Collections</related>
         <related type="Article" href="/dotnet/standard/collections/thread-safe/blockingcollection-overview">BlockingCollection Overview</related>
       </Docs>

xml/System.Collections.Immutable/ImmutableArray.xml

@@ -289,10 +289,10 @@
         <Parameter Name="items" Type="System.ReadOnlySpan&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="items">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of element stored in the array.</typeparam>
+        <param name="items">The elements to store in the array.</param>
+        <summary>Creates an <see cref="T:System.Collections.Immutable.ImmutableArray`1" /> with the specified elements.</summary>
+        <returns>An immutable array containing the specified items.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -318,10 +318,10 @@
         <Parameter Name="items" Type="System.Span&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="items">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of element stored in the array.</typeparam>
+        <param name="items">The elements to store in the array.</param>
+        <summary>Creates an <see cref="T:System.Collections.Immutable.ImmutableArray`1" /> with the specified elements.</summary>
+        <returns>An immutable array containing the specified items.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -976,10 +976,10 @@ This overload allows helper methods or custom builder classes to efficiently avo
         <Parameter Name="items" Type="System.ReadOnlySpan&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" RefType="this" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="items">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of element in the list.</typeparam>
+        <param name="items">The elements to store in the array.</param>
+        <summary>Produce an immutable array of contents from specified elements.</summary>
+        <returns>An immutable array containing the items in the span.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -1005,10 +1005,10 @@ This overload allows helper methods or custom builder classes to efficiently avo
         <Parameter Name="items" Type="System.Span&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" RefType="this" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="items">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of element in the list.</typeparam>
+        <param name="items">The elements to store in the array.</param>
+        <summary>Converts the span to an immutable array.</summary>
+        <returns>An immutable array containing the items in the span.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Collections.Immutable/ImmutableArray`1+Builder.xml

@@ -216,8 +216,8 @@
         <Parameter Name="items" Type="System.ReadOnlySpan&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <param name="items">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="items">The items to add at the end of the array.</param>
+        <summary>Adds the specified items to the end of the array.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -440,8 +440,8 @@
       </Parameters>
       <Docs>
         <typeparam name="TDerived">To be added.</typeparam>
-        <param name="items">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="items">The items to add at the end of the array.</param>
+        <summary>Adds the specified items to the end of the array.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -606,8 +606,8 @@
         <Parameter Name="destination" Type="System.Span&lt;T&gt;" Index="0" FrameworkAlternate="net-7.0" />
       </Parameters>
       <Docs>
-        <param name="destination">To be added.</param>
-        <summary>To be added.</summary>
+        <param name="destination">The <see cref="T:System.Span`1" /> to copy to.</param>
+        <summary>Copies the current contents to the specified <see cref="T:System.Span`1" />.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>