add notes in io.WritableComparator