Merge pull request #10262 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.Buffers.Text/Base64Url.xml

@@ -14,7 +14,7 @@
   </Base>
   <Interfaces />
   <Docs>
-    <summary>To be added.</summary>
+    <summary>Converts between binary data and URL-safe ASCII encoded text that's represented in Base64Url characters.</summary>
     <remarks>To be added.</remarks>
   </Docs>
   <Members>
@@ -525,9 +525,9 @@
         <Parameter Name="bytesLength" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="bytesLength">To be added.</param>
+        <param name="bytesLength">The size of the input span.</param>
         <summary>Returns the length (in bytes) of the result if you were to encode binary data within a byte span of size <paramref name="bytesLength" />.</summary>
-        <returns>To be added.</returns>
+        <returns>The length (in bytes) of the encoded result.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">
           <paramref name="bytesLength" /> is less than 0 or greater than 1610612733.</exception>
@@ -552,9 +552,9 @@
         <Parameter Name="base64Length" Type="System.Int32" />
       </Parameters>
       <Docs>
-        <param name="base64Length">To be added.</param>
+        <param name="base64Length">The size of the input span.</param>
         <summary>Returns the maximum length (in bytes) of the result if you were to decode base 64 encoded text from a span of size <paramref name="base64Length" />.</summary>
-        <returns>To be added.</returns>
+        <returns>The maximum length (in bytes) of the decoded result.</returns>
         <remarks>To be added.</remarks>
         <exception cref="T:System.ArgumentOutOfRangeException">The specified <paramref name="base64Length" /> is less than 0.</exception>
       </Docs>

xml/System.Runtime.CompilerServices/ParamCollectionAttribute.xml

@@ -37,7 +37,7 @@
       </AssemblyInfo>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>Initializes a new instance of the <see cref="T:System.Runtime.CompilerServices.ParamCollectionAttribute" />class.</summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Text/StringBuilder.xml

@@ -7035,7 +7035,7 @@ In .NET Core and in the .NET Framework 4.0 and later versions, when you instanti
         <param name="oldValue">The read-only character span to replace.</param>
         <param name="newValue">The read-only character span to replace <paramref name="oldValue" /> with.</param>
         <summary>Replaces all instances of one read-only character span with another in this builder.</summary>
-        <returns>To be added.</returns>
+        <returns>A reference to this instance with <paramref name="oldChar" /> replaced by <paramref name="newChar" />.</returns>
         <remarks>If <paramref name="newValue" /> is empty, instances of <paramref name="oldValue" /> are removed from this builder.</remarks>
       </Docs>
     </Member>
@@ -7233,7 +7233,7 @@ In .NET Core and in the .NET Framework 4.0 and later versions, when you instanti
         <param name="startIndex">The index to start in this builder.</param>
         <param name="count">The number of characters to read in this builder.</param>
         <summary>Replaces all instances of one read-only character span with another in part of this builder.</summary>
-        <returns>To be added.</returns>
+        <returns>A reference to this instance with <paramref name="oldChar" /> replaced by <paramref name="newChar" />.</returns>
         <remarks>If <paramref name="newValue" /> is empty, instances of <paramref name="oldValue" /> are removed from this builder.</remarks>
       </Docs>
     </Member>

xml/System/TimeProvider.xml

@@ -33,7 +33,7 @@
   </Attributes>
   <Docs>
     <summary>Provides an abstraction for time.</summary>
-    <remarks>To be added.</remarks>
+    <remarks>To make it easier to test time-dependent code, you can use <see cref="T:Microsoft.Extensions.Time.Testing.FakeTimeProvider" /> from the Microsoft.Extensions.Time.Testing package.</remarks>
   </Docs>
   <Members>
     <Member MemberName=".ctor">