DOC: Extend docstring pandas core index to_frame method (pandas-dev#20036)

stijnvanhoey · pandres · commit c36f8a20bca4 · 2018-03-10T09:53:33.000-06:00
diff --git a/pandas/core/indexes/base.py b/pandas/core/indexes/base.py
@@ -1148,7 +1148,26 @@ def to_frame(self, index=True):
 
         Returns
         -------
-        DataFrame : a DataFrame containing the original Index data.
+        DataFrame
+            DataFrame containing the original Index data.
+
+        Examples
+        --------
+        >>> idx = pd.Index(['Ant', 'Bear', 'Cow'], name='animal')
+        >>> idx.to_frame()
+            animal
+        animal       
+        Ant       Ant
+        Bear     Bear
+        Cow       Cow
+
+        By default, the original Index is reused. To enforce a new Index:
+
+        >>> idx.to_frame(index=False)
+            animal
+        0   Ant
+        1  Bear
+        2   Cow
         """
 
         from pandas import DataFrame
