Merge pull request #12519 from dotnet/main

Merge main into live

Author: dotnet-policy-service[bot]

xml/System.Linq/Enumerable.xml

@@ -11177,12 +11177,9 @@ The following code example demonstrates how to use <xref:System.Linq.Enumerable.
 
 ## Remarks
 
-This method is implemented by using deferred execution. The immediate return value is an object
-             that stores all the information that is required to perform the action.
-             The query represented by this method is not executed until the object is enumerated by calling
-             its <see cref="M:System.Collections.Generic.IEnumerable`1.GetEnumerator> method.
+This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <xref:System.Collections.Generic.IEnumerable`1.GetEnumerator*> method directly or by using `foreach` in C# or `For Each` in Visual Basic.
 
-This method compares elements by using the default comparer <see cref="P:System.Collections.Generic.Comparer`1.Default>.
+This method compares elements by using the default comparer <xref:System.Collections.Generic.Comparer`1.Default*>.
 
           ]]></format>
         </remarks>
@@ -11247,12 +11244,9 @@ This method compares elements by using the default comparer <see cref="P:System.
 
 ## Remarks
 
-This method is implemented by using deferred execution. The immediate return value is an object
-             that stores all the information that is required to perform the action.
-             The query represented by this method is not executed until the object is enumerated by calling
-             its <see cref="M:System.Collections.Generic.IEnumerable`1.GetEnumerator> method.
+This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <xref:System.Collections.Generic.IEnumerable`1.GetEnumerator*> method directly or by using `foreach` in C# or `For Each` in Visual Basic.
 
-If comparer is `null`, the default comparer <see cref="P:System.Collections.Generic.Comparer`1.Default> is used to compare elements.
+If `comparer` is `null`, the default comparer <xref:System.Collections.Generic.Comparer`1.Default*> is used to compare elements.
 
           ]]></format>
         </remarks>
@@ -11737,12 +11731,9 @@ If comparer is `null`, the default comparer <see cref="P:System.Collections.Gene
 
 ## Remarks
 
-This method is implemented by using deferred execution. The immediate return value is an object
-             that stores all the information that is required to perform the action.
-             The query represented by this method is not executed until the object is enumerated by calling
-             its <see cref="M:System.Collections.Generic.IEnumerable`1.GetEnumerator> method.
+This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <xref:System.Collections.Generic.IEnumerable`1.GetEnumerator*> method directly or by using `foreach` in C# or `For Each` in Visual Basic.
 
-This method compares elements by using the default comparer <see cref="P:System.Collections.Generic.Comparer`1.Default>.
+This method compares elements by using the default comparer <xref:System.Collections.Generic.Comparer`1.Default*>.
 
           ]]></format>
         </remarks>
@@ -11807,12 +11798,9 @@ This method compares elements by using the default comparer <see cref="P:System.
 
 ## Remarks
 
-This method is implemented by using deferred execution. The immediate return value is an object
-             that stores all the information that is required to perform the action.
-             The query represented by this method is not executed until the object is enumerated by calling
-             its <see cref="M:System.Collections.Generic.IEnumerable`1.GetEnumerator> method.
+This method is implemented by using deferred execution. The immediate return value is an object that stores all the information that is required to perform the action. The query represented by this method is not executed until the object is enumerated either by calling its <xref:System.Collections.Generic.IEnumerable`1.GetEnumerator*> method directly or by using `foreach` in C# or `For Each` in Visual Basic.
 
-If comparer is `null`, the default comparer <see cref="P:System.Collections.Generic.Comparer`1.Default> is used to compare elements.
+If `comparer` is `null`, the default comparer <xref:System.Collections.Generic.Comparer`1.Default*> is used to compare elements.
 
           ]]></format>
         </remarks>