DOC: Add line clarifying sorting using sort_values() (#60734)

fix docs
pandas-dev · Jan 21, 2025 · 31704e3 · 31704e3
1 parent 42bf375
commit 31704e3
Show file tree

Hide file tree

Showing 2 changed files with 4 additions and 2 deletions.
diff --git a/pandas/core/frame.py b/pandas/core/frame.py
@@ -6890,7 +6890,8 @@ def sort_values(
             builtin :meth:`sorted` function, with the notable difference that
             this `key` function should be *vectorized*. It should expect a
             ``Series`` and return a Series with the same shape as the input.
-            It will be applied to each column in `by` independently.
+            It will be applied to each column in `by` independently. The values in the
+            returned Series will be used as the keys for sorting.
 
         Returns
         -------

diff --git a/pandas/core/generic.py b/pandas/core/generic.py
@@ -4884,7 +4884,8 @@ def sort_values(
             builtin :meth:`sorted` function, with the notable difference that
             this `key` function should be *vectorized*. It should expect a
             ``Series`` and return a Series with the same shape as the input.
-            It will be applied to each column in `by` independently.
+            It will be applied to each column in `by` independently. The values in the
+            returned Series will be used as the keys for sorting.
 
         Returns
         -------