From fd89cde26953f96ede56525d0a9bc6a967907218 Mon Sep 17 00:00:00 2001
From: Edward Brey <edward@breyfamily.net>
Date: Fri, 1 Nov 2019 17:08:33 -0500
Subject: [PATCH] Define group value order

Documents that the grouping is stable.
---
 xml/System.Linq/Enumerable.xml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/xml/System.Linq/Enumerable.xml b/xml/System.Linq/Enumerable.xml
index 2df65139394..290a4d597a1 100644
--- a/xml/System.Linq/Enumerable.xml
+++ b/xml/System.Linq/Enumerable.xml
@@ -11623,7 +11623,7 @@ Only unique elements are returned.
         <param name="source">An <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Collections.Generic.Dictionary`2" /> from.</param>
         <param name="keySelector">A function to extract a key from each element.</param>
         <summary>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function.</summary>
-        <returns>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains keys and values.</returns>
+        <returns>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains keys and values. The values within each group are in the same order as in <paramref name="source" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -11695,7 +11695,7 @@ Only unique elements are returned.
         <param name="keySelector">A function to extract a key from each element.</param>
         <param name="comparer">An <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare keys.</param>
         <summary>Creates a <see cref="T:System.Collections.Generic.Dictionary`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function and key comparer.</summary>
-        <returns>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains keys and values.</returns>
+        <returns>A <see cref="T:System.Collections.Generic.Dictionary`2" /> that contains keys and values. The values within each group are in the same order as in <paramref name="source" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -12047,7 +12047,7 @@ Only unique elements are returned.
         <param name="source">The <see cref="T:System.Collections.Generic.IEnumerable`1" /> to create a <see cref="T:System.Linq.Lookup`2" /> from.</param>
         <param name="keySelector">A function to extract a key from each element.</param>
         <summary>Creates a <see cref="T:System.Linq.Lookup`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function.</summary>
-        <returns>A <see cref="T:System.Linq.Lookup`2" /> that contains keys and values.</returns>
+        <returns>A <see cref="T:System.Linq.Lookup`2" /> that contains keys and values. The values within each group are in the same order as in <paramref name="source" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[  
   
@@ -12107,7 +12107,7 @@ Only unique elements are returned.
         <param name="keySelector">A function to extract a key from each element.</param>
         <param name="comparer">An <see cref="T:System.Collections.Generic.IEqualityComparer`1" /> to compare keys.</param>
         <summary>Creates a <see cref="T:System.Linq.Lookup`2" /> from an <see cref="T:System.Collections.Generic.IEnumerable`1" /> according to a specified key selector function and key comparer.</summary>
-        <returns>A <see cref="T:System.Linq.Lookup`2" /> that contains keys and values.</returns>
+        <returns>A <see cref="T:System.Linq.Lookup`2" /> that contains keys and values. The values within each group are in the same order as in <paramref name="source" />.</returns>
         <remarks>
           <format type="text/markdown"><![CDATA[