preliminary docs for #65 sort