manually merged docs from @Arkkimaagi
update documentation for `withSort`, pre @Arkkimaagi