Net10 docs update

xml/System.CodeDom.Compiler/IndentedTextWriter.xml

@@ -350,6 +350,7 @@
         <summary>Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources asynchronously.</summary>
         <returns>A <see cref="T:System.Threading.Tasks.ValueTask" /> representing the asynchronous dispose operation.</returns>
         <remarks>To be added.</remarks>
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="Encoding">
@@ -486,6 +487,7 @@
         <summary>Clears all buffers for this <see cref="T:System.CodeDom.Compiler.IndentedTextWriter" /> asynchronously and causes any buffered data to be written to the underlying device.</summary>
         <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous flush operation.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:System.CodeDom.Compiler.IndentedTextWriter.Flush" />.</remarks>
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="FlushAsync">
@@ -2682,6 +2684,7 @@
         <summary>Asynchronously writes the line terminator to the underlying <see cref="T:System.IO.TextWriter" />.</summary>
         <returns>A <see cref="T:System.Threading.Tasks.Task" /> representing the asynchronous line writing operation.</returns>
         <remarks>This method stores in the task it returns all non-usage exceptions that the method's synchronous counterpart can throw. If an exception is stored into the returned task, that exception will be thrown when the task is awaited. Usage exceptions, such as <see cref="T:System.ArgumentException" />, are still thrown synchronously. For the stored exceptions, see the exceptions thrown by <see cref="M:System.CodeDom.Compiler.IndentedTextWriter.WriteLine" />.</remarks>
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="WriteLineAsync">

xml/System.Collections.Generic/CollectionExtensions.xml

@@ -179,11 +179,15 @@
         <Parameter Name="set" Type="System.Collections.Generic.ISet&lt;T&gt;" Index="0" FrameworkAlternate="net-10.0" RefType="this" />
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="set">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of elements in the set.</typeparam>
+        <param name="set">The set to wrap.</param>
+        <summary>
+          <para>Returns a read-only <see cref="T:System.Collections.ObjectModel.ReadOnlySet`1" /> wrapper for the specified set.</para>
+        </summary>
+        <returns>An object that acts as a read-only wrapper around the current <see cref="T:System.Collections.Generic.ISet`1" />.</returns>
         <remarks>To be added.</remarks>
+        <exception cref="T:System.ArgumentNullException">
+          <paramref name="set" /> is <see langword="null" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="AsReadOnly&lt;TKey,TValue&gt;">

xml/System.Collections.Generic/Queue`1.xml

@@ -1200,6 +1200,7 @@
  ]]></format>
         </remarks>
         <altmember cref="P:System.Collections.ICollection.SyncRoot" />
+        <inheritdoc cref="P:System.Collections.ICollection.IsSynchronized" />
       </Docs>
     </Member>
     <Member MemberName="System.Collections.ICollection.SyncRoot">

xml/System.Collections.ObjectModel/ReadOnlyCollection.xml

@@ -20,7 +20,7 @@
     </Attribute>
   </Attributes>
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Provides static methods for read-only collections.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -68,10 +68,13 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="values">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of elements in the collection.</typeparam>
+        <param name="values">The span of values to include in the collection.</param>
+        <summary>
+          <para>Creates a new <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" /> from the specified span of values.</para>
+          <para>This method (simplifies collection initialization)[/dotnet/csharp/language-reference/operators/collection-expressions] to create a new <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" /> with the specified values.</para>
+        </summary>
+        <returns>A new <see cref="T:System.Collections.ObjectModel.ReadOnlyCollection`1" /> containing the specified values.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -119,10 +122,13 @@
         </Parameter>
       </Parameters>
       <Docs>
-        <typeparam name="T">To be added.</typeparam>
-        <param name="values">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <typeparam name="T">The type of elements in the collection.</typeparam>
+        <param name="values">The span of values to include in the collection.</param>
+        <summary>
+          <para>Creates a new <see cref="T:System.Collections.ObjectModel.ReadOnlySet`1" /> from the specified span of values.</para>
+          <para>This method (simplifies collection initialization)[/dotnet/csharp/language-reference/operators/collection-expressions] to create a new <see cref="T:System.Collections.ObjectModel.ReadOnlySet`1" /> with the specified values.</para>
+        </summary>
+        <returns>A new <see cref="T:System.Collections.ObjectModel.ReadOnlySet`1" /> containing the specified values.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Collections.ObjectModel/ReadOnlySet`1.xml

@@ -125,6 +125,7 @@
         <returns>
           <see langword="true" /> if <paramref name="item" /> is found in the <see cref="T:System.Collections.Generic.ICollection`1" />; otherwise, <see langword="false" />.</returns>
         <remarks>To be added.</remarks>
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="Count">
@@ -790,6 +791,7 @@
         <param name="index">The zero-based index in <paramref name="array" /> at which copying begins.</param>
         <summary>Copies the elements of the <see cref="T:System.Collections.ICollection" /> to an <see cref="T:System.Array" />, starting at a particular <see cref="T:System.Array" /> index.</summary>
         <remarks>To be added.</remarks>
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="System.Collections.ICollection.IsSynchronized">
@@ -819,6 +821,7 @@
         <value>
           <see langword="true" /> if access to the <see cref="T:System.Collections.ICollection" /> is synchronized (thread safe); otherwise, <see langword="false" />.</value>
         <remarks>This member is an explicit interface member implementation. It can be used only when the &lt;xref:System.Collections.ObjectModel.ReadOnlySet`1&gt; instance is cast to an &lt;xref:System.Collections.ICollection&gt; interface.</remarks>
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="System.Collections.ICollection.SyncRoot">
@@ -847,6 +850,7 @@
         <summary>Gets an object that can be used to synchronize access to the <see cref="T:System.Collections.ICollection" />.</summary>
         <value>An object that can be used to synchronize access to the <see cref="T:System.Collections.ICollection" />.</value>
         <remarks>This member is an explicit interface member implementation. It can be used only when the &lt;xref:System.Collections.ObjectModel.ReadOnlySet`1&gt; instance is cast to an &lt;xref:System.Collections.ICollection&gt; interface.</remarks>
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="System.Collections.IEnumerable.GetEnumerator">
@@ -876,6 +880,7 @@
         <summary>Returns an enumerator that iterates through a collection.</summary>
         <returns>An <see cref="T:System.Collections.IEnumerator" /> object that can be used to iterate through the collection.</returns>
         <remarks>This member is an explicit interface member implementation. It can be used only when the &lt;xref:System.Collections.ObjectModel.ReadOnlySet`1&gt; instance is cast to an &lt;xref:System.Collections.IEnumerable&gt; interface.</remarks>
+        <inheritdoc />
       </Docs>
     </Member>
   </Members>

xml/System.Collections/BitArray.xml

@@ -639,6 +639,7 @@
  The number of elements in the source <see cref="T:System.Collections.BitArray" /> is greater than the available space from <paramref name="index" /> to the end of the destination <paramref name="array" />.</exception>
         <exception cref="T:System.InvalidCastException">The type of the source <see cref="T:System.Collections.BitArray" /> cannot be cast automatically to the type of the destination <paramref name="array" />.</exception>
         <altmember cref="T:System.Array" />
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="Count">

xml/System.Diagnostics.CodeAnalysis/DynamicallyAccessedMemberTypes.xml

@@ -78,7 +78,7 @@
       </ReturnValue>
       <MemberValue>1064967</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all constructors, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="AllEvents">
@@ -98,7 +98,7 @@
       </ReturnValue>
       <MemberValue>530432</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all events, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="AllFields">
@@ -118,7 +118,7 @@
       </ReturnValue>
       <MemberValue>65632</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all fields, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="AllMethods">
@@ -138,7 +138,7 @@
       </ReturnValue>
       <MemberValue>32792</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all methods, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="AllNestedTypes">
@@ -158,7 +158,7 @@
       </ReturnValue>
       <MemberValue>2228608</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all nested types, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="AllProperties">
@@ -178,7 +178,7 @@
       </ReturnValue>
       <MemberValue>263680</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all properties, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="Interfaces">
@@ -274,7 +274,7 @@
       </ReturnValue>
       <MemberValue>16388</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public constructors, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="NonPublicEvents">
@@ -320,7 +320,7 @@
       </ReturnValue>
       <MemberValue>528384</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public events, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="NonPublicFields">
@@ -366,7 +366,7 @@
       </ReturnValue>
       <MemberValue>65600</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public fields, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="NonPublicMethods">
@@ -412,7 +412,7 @@
       </ReturnValue>
       <MemberValue>32784</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public methods, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="NonPublicNestedTypes">
@@ -458,7 +458,7 @@
       </ReturnValue>
       <MemberValue>131328</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public nested types, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="NonPublicProperties">
@@ -504,7 +504,7 @@
       </ReturnValue>
       <MemberValue>263168</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all non-public properties, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="PublicConstructors">
@@ -550,7 +550,7 @@
       </ReturnValue>
       <MemberValue>1048579</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all public constructors, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="PublicEvents">
@@ -674,7 +674,7 @@
       </ReturnValue>
       <MemberValue>2097280</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Specifies all public nested types, including those inherited from base classes.</summary>
       </Docs>
     </Member>
     <Member MemberName="PublicParameterlessConstructor">

xml/System.Diagnostics.CodeAnalysis/ExperimentalAttribute.xml

@@ -116,9 +116,9 @@ the warnings or errors, if needed.
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <summary>Gets or sets an optional message associated with the experimental attribute.</summary>
+        <value>The message that provides additional information about the experimental feature.</value>
+        <remarks>This message can be used to provide more context or guidance about the experimental feature.</remarks>
       </Docs>
     </Member>
     <Member MemberName="UrlFormat">

xml/System.Diagnostics.CodeAnalysis/RequiresDynamicCodeAttribute.xml

@@ -81,7 +81,7 @@ For more information, see [Introduction to AOT warnings](/dotnet/core/deploying/
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets a value that indicates whether the annotation should apply to static members.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Diagnostics.CodeAnalysis/RequiresUnreferencedCodeAttribute.xml

@@ -89,7 +89,7 @@ This attribute allows tools to understand which methods are unsafe to call when
         <ReturnType>System.Boolean</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Gets or sets a value that indicates whether the annotation should apply to static members.</summary>
         <value>To be added.</value>
         <remarks>To be added.</remarks>
       </Docs>

xml/System.Globalization/CompareOptions.xml

@@ -401,7 +401,11 @@ The following code example shows how sorting with StringSort differs from sortin
       </ReturnValue>
       <MemberValue>32</MemberValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+          <para>The option that specifies that string comparisons sort sequences of digits (Unicode general category "Nd") based on their numeric value.</para>
+          <para>For example, "2" comes before "10". Non-digit characters such as decimal points, minus, and plus signs</para>
+          <para>are not considered as part of the sequence and will terminate it. This flag is not valid for indexing methods (such as <see cref="M:System.Globalization.CompareInfo.IndexOf(System.String,System.String,System.Globalization.CompareOptions)" /> and <see cref="M:System.Globalization.CompareInfo.IsPrefix(System.String,System.String,System.Globalization.CompareOptions)" />).</para>
+        </summary>
       </Docs>
     </Member>
     <Member MemberName="Ordinal">

xml/System.Globalization/ISOWeek.xml

@@ -59,9 +59,9 @@
         <Parameter Name="date" Type="System.DateOnly" Index="0" FrameworkAlternate="net-10.0" />
       </Parameters>
       <Docs>
-        <param name="date">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="date">A date in the Gregorian calendar.</param>
+        <summary>Calculates the ISO week number of a given Gregorian date.</summary>
+        <returns>A number between 1 and 53 representing the ISO week number of the given Gregorian date.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -167,9 +167,9 @@
         <Parameter Name="date" Type="System.DateOnly" Index="0" FrameworkAlternate="net-10.0" />
       </Parameters>
       <Docs>
-        <param name="date">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="date">A date in the Gregorian calendar.</param>
+        <summary>Calculates the ISO week-numbering year (also called ISO year informally) mapped to the input Gregorian date.</summary>
+        <returns>The ISO week-numbering year, between 1 and 9999</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -311,11 +311,11 @@
         <Parameter Name="dayOfWeek" Type="System.DayOfWeek" Index="2" FrameworkAlternate="net-10.0" />
       </Parameters>
       <Docs>
-        <param name="year">To be added.</param>
-        <param name="week">To be added.</param>
-        <param name="dayOfWeek">To be added.</param>
-        <summary>To be added.</summary>
-        <returns>To be added.</returns>
+        <param name="year">An ISO week-numbering year (also called an ISO year informally).</param>
+        <param name="week">The ISO week number in the given ISO week-numbering year.</param>
+        <param name="dayOfWeek">The day of week inside the given ISO week.</param>
+        <summary>Maps the ISO week date represented by a specified ISO year, week number, and day of week to the equivalent Gregorian date.</summary>
+        <returns>The Gregorian date equivalent to the input ISO week date.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.IO/BinaryReader.xml

@@ -1837,9 +1837,12 @@
         <Parameter Name="buffer" Type="System.Span&lt;System.Byte&gt;" Index="0" FrameworkAlternate="net-10.0" />
       </Parameters>
       <Docs>
-        <param name="buffer">To be added.</param>
-        <summary>To be added.</summary>
-        <remarks>To be added.</remarks>
+        <param name="buffer">A region of memory. When this method returns, the contents of this region are replaced by the bytes read from the current stream.</param>
+        <summary>Reads bytes from the current stream and advances the position within the stream until the <paramref name="buffer" /> is filled.</summary>
+        <remarks>When <paramref name="buffer" /> is empty, this read operation will be completed without waiting for available data in the stream.</remarks>
+        <exception cref="T:System.ObjectDisposedException">The stream is closed.</exception>
+        <exception cref="T:System.IO.IOException">An I/O error occurred.</exception>
+        <exception cref="T:System.IO.EndOfStreamException">The end of the stream is reached before filling the <paramref name="buffer" />.</exception>
       </Docs>
     </Member>
     <Member MemberName="ReadHalf">

xml/System.IO/FileStream.xml

@@ -2291,6 +2291,7 @@ For an example of copying between two streams, see the <xref:System.IO.Stream.Co
           ]]></format>
         </remarks>
         <exception cref="T:System.OperationCanceledException">The cancellation token was canceled. This exception is stored into the returned task.</exception>
+        <inheritdoc />
       </Docs>
     </Member>
     <Member MemberName="Dispose">

xml/System.Net.Http/HttpIOException.xml

@@ -92,8 +92,8 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
-        <value>To be added.</value>
+        <summary>Gets a message that describes the current exception.</summary>
+        <value>The error message that explains the reason for the exception, or an empty string ("").</value>
         <remarks>To be added.</remarks>
         <inheritdoc />
       </Docs>