I did not want to copy-paste documentation from one function to another, this is why I referenced pairwise_distance, where users can find more detail. Should I be more explicit in the docstring?