update documentation for `withSort`, pre @Arkkimaagi