[doc][algorithms] add documentation for the comparable_distance free
function that takes a strategy