Merge pull request #11956 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.Numerics/Vector.xml

@@ -9222,7 +9222,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9255,7 +9255,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9288,7 +9288,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9321,7 +9321,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9354,7 +9354,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9393,7 +9393,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9432,7 +9432,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9471,7 +9471,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9510,7 +9510,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9549,7 +9549,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9582,7 +9582,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (signed) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9615,7 +9615,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (signed) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9648,7 +9648,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (signed) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9681,7 +9681,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (signed) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9720,7 +9720,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (signed) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9753,7 +9753,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9786,7 +9786,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9819,7 +9819,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9852,7 +9852,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9885,7 +9885,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9924,7 +9924,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -9963,7 +9963,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -10002,7 +10002,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -10041,7 +10041,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -10080,7 +10080,7 @@ Note that this method returns a <xref:System.Single> instead of an integral type
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System.Numerics/Vector`1.xml

@@ -2305,7 +2305,7 @@ The type `T` can be any of the following numeric types:
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts each element of a vector left by the specified amount.</summary>
-        <returns>A vector whose elements where shifted left by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted left by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2584,7 +2584,7 @@ The type `T` can be any of the following numeric types:
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (signed) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -2798,7 +2798,7 @@ The type `T` can be any of the following numeric types:
         <param name="value">The vector whose elements are to be shifted.</param>
         <param name="shiftCount">The number of bits by which to shift each element.</param>
         <summary>Shifts (unsigned) each element of a vector right by the specified amount.</summary>
-        <returns>A vector whose elements where shifted right by <paramref name="shiftCount" />.</returns>
+        <returns>A vector whose elements were shifted right by <paramref name="shiftCount" />.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System/MemoryExtensions.xml

@@ -7833,9 +7833,9 @@ Invalid sequences will be represented in the enumeration by <xref:System.Text.Ru
       </Parameters>
       <Docs>
         <param name="span">The source span.</param>
-        <summary>Indicates whether the specified span contains only whitespace characters.</summary>
+        <summary>Indicates whether the specified span is empty or contains only whitespace characters.</summary>
         <returns>
-          <see langword="true" /> if the span contains only whitespace characters, <see langword="false" /> otherwise.</returns>
+          <see langword="true" /> if the span is empty or contains only whitespace characters, <see langword="false" /> otherwise.</returns>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>

xml/System/ReadOnlySpan`1.xml

@@ -179,7 +179,7 @@ A `ReadOnlySpan<T>` instance is often used to reference the elements of an array
         <param name="array">The array from which to create the <see cref="T:System.ReadOnlySpan`1" />.</param>
         <summary>Creates a new <see cref="T:System.ReadOnlySpan`1" /> over the entirety of a specified array.</summary>
         <remarks>
-          <format type="text/markdown"><![CDATA[If the array is null, this constructor returns a null `ReadOnlySpan<T>`.]]></format>
+          <format type="text/markdown"><![CDATA[If the `array` is null, this constructor returns a `default` `ReadOnlySpan<T>`.]]></format>
         </remarks>
       </Docs>
     </Member>
@@ -290,7 +290,7 @@ A `ReadOnlySpan<T>` instance is often used to reference the elements of an array
 
 ### Remarks
 
-This method returns `default` when `array` is `null`.
+If the `array` is null, this constructor returns a `default` `ReadOnlySpan<T>`.
 
             ]]></format>
         </remarks>