DOC: Add docstrings to DataFrame properties, #10421

Explanations for `axes` and `shape`.

Author: gambogi

pandas/core/frame.py

@@ -414,10 +414,17 @@ 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 [self.index, self.columns]
 
     @property
     def shape(self):
+        """
+        Return a tuple representing the dimensionality of the DataFrame.
+        """
         return (len(self.index), len(self.columns))
 
     def _repr_fits_vertical_(self):

pandas/core/generic.py

@@ -382,12 +382,12 @@ def _stat_axis(self):
 
     @property
     def shape(self):
-        "tuple of axis dimensions"
+        "Return a tuple of axis dimensions"
         return tuple(len(self._get_axis(a)) for a in self._AXIS_ORDERS)
 
     @property
     def axes(self):
-        "index(es) of the NDFrame"
+        "Return index label(s) of the internal NDFrame"
         # we do it this way because if we have reversed axes, then
         # the block manager shows then reversed
         return [self._get_axis(a) for a in self._AXIS_ORDERS]

pandas/core/series.py

@@ -468,6 +468,9 @@ def _unpickle_series_compat(self, state):
     # indexers
     @property
     def axes(self):
+        """
+        Return a list of the row axis labels
+        """
         return [self.index]
 
     def _ixs(self, i, axis=0):