Merge pull request #5201 from christophebourguignat/master

GaelVaroquaux · GaelVaroquaux · commit e2e5fbd8e155 · 2015-09-02T07:16:11.000+02:00
DOC Clarify random_state parameter in KFold() doc
diff --git a/sklearn/cross_validation.py b/sklearn/cross_validation.py
@@ -254,7 +254,7 @@ class KFold(_BaseKFold):
     """K-Folds cross validation iterator.
 
     Provides train/test indices to split data in train test sets. Split
-    dataset into k consecutive folds (without shuffling).
+    dataset into k consecutive folds (without shuffling by default).
 
     Each fold is then used a validation set once while the k - 1 remaining
     fold form the training set.
@@ -273,8 +273,8 @@ class KFold(_BaseKFold):
         Whether to shuffle the data before splitting into batches.
 
     random_state : None, int or RandomState
-        Pseudo-random number generator state used for random
-        sampling. If None, use default numpy RNG for shuffling
+        When shuffle=True, pseudo-random number generator state used for 
+        shuffling. If None, use default numpy RNG for shuffling.
 
     Examples
     --------
@@ -363,8 +363,8 @@ class StratifiedKFold(_BaseKFold):
         into batches.
 
     random_state : None, int or RandomState
-        Pseudo-random number generator state used for random
-        sampling. If None, use default numpy RNG for shuffling
+        When shuffle=True, pseudo-random number generator state used for 
+        shuffling. If None, use default numpy RNG for shuffling.
 
     Examples
     --------
