Documentation for Enumerable.Distinct, Except, Intersect, Max, Min, Order, OrderDescending, Union should reference <name>By alternative

[EikeSchwass]

For many Linq methods alternatives exist which don't require custom comparers. Those methods have the suffix By. In many cases those methods are sufficient to achieve the desired funtionality and require less overhead.

A reference to those methods should be included in the documention of the original methods (without By).
https://learn.microsoft.com/en-us/dotnet/api/system.linq.enumerable?view=net-8.0#methods

[dotnet-policy-service]

Tagging subscribers to this area: @dotnet/area-system-linq