The description of the argument should state explicitly that the comparator passed in will provide the heap's definition of order.  The examples are good, but should refer to the comparator objects `defaultComparator` and `reverseComparator`, not the names of their types.