diff --git a/docs/conceptual/list.sortwith['t]-function-[fsharp].md b/docs/conceptual/list.sortwith['t]-function-[fsharp].md index 5340ba24..d24e4c0b 100644 --- a/docs/conceptual/list.sortwith['t]-function-[fsharp].md +++ b/docs/conceptual/list.sortwith['t]-function-[fsharp].md @@ -35,7 +35,13 @@ List.sortWith comparer list Type: **'T -> 'T ->**[int](https://msdn.microsoft.com/library/025d5455-3622-4ea5-9573-3ecbd4ee1375) -The function to compare the list elements. +The function to compare the list elements. The function should return -1, 0, or +1 based on the following table: + +| Return | If | +|--------|----------------------------------------------------------| +| -1 | The first argument should *precede* the second argument | +| +1 | The first argument should *follow* the second argument | +| 0 | The first argument is *equal* (for purpose of sorting) to the second argument and would also be equal to any other argument that is equal to the second. | *list* @@ -78,4 +84,4 @@ Supported in: 2.0, 4.0, Portable ## See Also [Collections.List Module (F#)](Collections.List-Module-%5BFSharp%5D.md) -[Microsoft.FSharp.Collections Namespace (F#)](Microsoft.FSharp.Collections-Namespace-%5BFSharp%5D.md) \ No newline at end of file +[Microsoft.FSharp.Collections Namespace (F#)](Microsoft.FSharp.Collections-Namespace-%5BFSharp%5D.md)