improve docs for Comparable