    "A comparator which orders elements in increasing order
     according to the `Comparable` value returned by the given
     [[comparable]] function.

          \"Hello World!\".sort(byIncreasing(Character.lowercased))

     This function is intended for use with [[Iterable.sort]]
     and [[Iterable.max]]."
    see (`function byDecreasing`,
         `function Iterable.max`,
         `function Iterable.sort`)
    shared Comparison byIncreasing<Element,Value>
                (Value comparable(Element e))
                (Element x, Element y)
            given Value satisfies Comparable<Value>
                    => comparable(x)<=>comparable(y);