CORE-5117 documented how sorting will work