 
   ## Ascending and descending
 
-  `sort/2` allows a developer to pass `:asc` or `:desc` as the sorting
-  function, which is a convenience for `<=/2` and `>=/2` respectively.
+  `sort/2` allows a developer to pass `:asc` or `:desc` as the sorter, which is a convenience for
+  [`&<=/2`](`<=/2`) and [`&>=/2`](`>=/2`) respectively.
 
       iex> Enum.sort([2, 3, 1], :asc)
       [1, 2, 3]


  This function maps each element of the `enumerable` using the
  provided `mapper` function. The enumerable is then sorted by
  the mapped elements using the `sorter` function, which defaults
  to `Kernel.<=/2`.

  `sort_by/3` differs from `sort/2` in that it only calculates the
  comparison value for each element in the enumerable once instead of


  ## Examples

  Using the default `sorter` of [`&<=/2`](`<=/2`) :

      iex> Enum.sort_by(["some", "kind", "of", "monster"], &byte_size/1)
      ["of", "some", "kind", "monster"]
