doc(python): Make python polars.DataFrame.sample shuffle description …

…more explicit (#7184)
pola-rs · Feb 25, 2023 · e6b9930 · e6b9930
1 parent 5f26668
commit e6b9930
Showing 1 changed file with 3 additions and 1 deletion.
diff --git a/py-polars/polars/internals/dataframe/frame.py b/py-polars/polars/internals/dataframe/frame.py
@@ -6843,7 +6843,9 @@ def sample(
         with_replacement
             Allow values to be sampled more than once.
         shuffle
-            Shuffle the order of sampled data points.
+            If set to True, the order of the sampled rows will be shuffled. If
+            set to False (default), the order of the returned rows will be
+            neither stable nor fully random.
         seed
             Seed for the random number generator. If set to None (default), a random
             seed is generated using the ``random`` module.