DOC: Improved the docstrings of NDFrame

This change includes the following property axes, shape, ndim, size

Author: yeongseon

pandas/core/frame.py

@@ -550,15 +550,33 @@ def _get_axes(N, K, index=index, columns=columns):
     @property
     def axes(self):
         """
-        Return a list with the row axis labels and column axis labels as the
-        only members. They are returned in that order.
+        Return a list representing the row axis labels and column axis labels
+        as the only members. They are returned in that order.
+
+        Examples
+        --------
+        >>> df = pd.DataFrame({'col1': [1, 2], 'col2': [3, 4]})
+        >>> df.axes
+        [RangeIndex(start=0, stop=2, step=1), Index(['coll', 'col2'],
+        dtype='object')]
         """
         return [self.index, self.columns]
 
     @property
     def shape(self):
         """
         Return a tuple representing the dimensionality of the DataFrame.
+
+        Examples
+        --------
+        >>> df = pd.DataFrame({'col1': [1, 2], 'col2': [3, 4]})
+        >>> df.shape
+        (2, 2)
+
+        >>> df = pd.DataFrame({'col0': [1, 2, 3], 'col2': [4, 5, 6],
+        ...                    'col3': [7, 8, 9]})
+        >>> df.shape
+        (3, 3)
         """
         return len(self.index), len(self.columns)
 

pandas/core/generic.py

@@ -457,12 +457,39 @@ def axes(self):
 
     @property
     def ndim(self):
-        """Number of axes / array dimensions"""
+        """
+        Return an int representing the number of axes / array dimensions.
+
+        Examples
+        --------
+        >>> df = pd.DataFrame({'col1': [1, 2], 'col2': [3, 4]})
+        >>> df.ndim
+        2
+
+        >>> df = pd.DataFrame({'col1': [1, 2, 3], 'col2': [4, 5, 6],
+        ...                    'col3': [7, 8, 9]})
+        >>> df.ndim
+        2
+        """
         return self._data.ndim
 
     @property
     def size(self):
-        """number of elements in the NDFrame"""
+        """
+        Return a numpy.int64 representing the number of elements
+        in this object.
+
+        Examples
+        --------
+        >>> df = pd.DataFrame({'col1': [1, 2], 'col2': [3, 4]})
+        >>> df.size
+        4
+
+        >>> df = pd.DataFrame({'col1': [1, 2, 3], 'col2': [4, 5, 6],
+        ...                    'col3': [7, 8, 9]})
+        >>> df.size
+        9
+        """
         return np.prod(self.shape)
 
     @property