DOC: Improved the docstring of pandas.Series.sample

Author: ottiP

pandas/core/generic.py

@@ -3718,7 +3718,9 @@ def tail(self, n=5):
     def sample(self, n=None, frac=None, replace=False, weights=None,
                random_state=None, axis=None):
         """
-        Returns a random sample of items from an axis of object.
+        Return a random sample of items from an axis of object.
+
+        You can use `random state` for reproducibility
 
         Parameters
         ----------
@@ -3753,9 +3755,17 @@ def sample(self, n=None, frac=None, replace=False, weights=None,
         -------
         A new object of same type as caller.
 
-        Examples
+        See Also
         --------
+        Series.sample : Returns a random sample of items
+            from an axis of object.
+        DataFrame.sample : Returns a random sample of items
+            from an axis of object.
+        Panel.sample : Returns a random sample of items
+            from an axis of object.
 
+        Examples
+        --------
         Generate an example ``Series`` and ``DataFrame``:
 
         >>> s = pd.Series(np.random.randn(50))