Updates to sinhrks comments

Author: Nick Eubank

doc/source/api.rst

@@ -714,7 +714,6 @@ Indexing, iteration
    DataFrame.where
    DataFrame.mask
    DataFrame.query
-   DataFrame.sample
 
 For more information on ``.at``, ``.iat``, ``.ix``, ``.loc``, and
 ``.iloc``,  see the :ref:`indexing documentation <indexing>`.
@@ -1074,6 +1073,7 @@ Reindexing / Selection / Label manipulation
    Panel.reindex_axis
    Panel.reindex_like
    Panel.rename
+   Panel.sample
    Panel.select
    Panel.take
    Panel.truncate

doc/source/whatsnew/v0.16.1.txt

@@ -11,11 +11,12 @@ Highlights include:
 
 - Support for a ``CategoricalIndex``, a category based index, see :ref:`here <whatsnew_0161.enhancements.categoricalindex>`
 
+- New method ``sample`` for drawing random samples from Series, DataFrames and Panels. See :ref:`here <whatsnew_0161.enchancements.sample>` 
+
 .. contents:: What's new in v0.16.1
     :local:
     :backlinks: none
 
-
 .. _whatsnew_0161.enhancements:
 
 Enhancements

pandas/core/generic.py

@@ -1951,15 +1951,15 @@ def tail(self, n=5):
 
     def sample(self, n=None, frac=None, replace=False, weights=None, random_state=None, axis = 0):
         """
-        Returns a random sample of rows from object. 
+        Returns a random sample of items from an axis of object. 
         
         Parameters
         ----------
         n : int, optional
-            Number of rows to return. Cannot be used with `frac`.
+            Number of items from axis to return. Cannot be used with `frac`.
             Default = 1 if `frac` = None. 
         frac : float, optional
-            Fraction of rows to return. Cannot be used with `n`. 
+            Fraction of axis items to return. Cannot be used with `n`. 
         replace : boolean, optional
             Sample with or without replacement. Default = False. 
         weights : str or ndarray-like, optional