Merge pull request #9803 from evanpw/interpolate_example

DOC: Fix broken formatting on docstring examples with first-line comments

Author: jorisvandenbossche

pandas/core/generic.py

@@ -2735,7 +2735,8 @@ def interpolate(self, method='linear', axis=0, limit=None, inplace=False,
         Examples
         --------
 
-        # Filling in NaNs:
+        Filling in NaNs
+
         >>> s = pd.Series([0, 1, np.nan, 3])
         >>> s.interpolate()
         0    0
@@ -2962,13 +2963,13 @@ def groupby(self, by=None, axis=0, level=None, as_index=True, sort=True,
 
         Examples
         --------
-        # DataFrame result
-        >>> data.groupby(func, axis=0).mean()
+        DataFrame results
 
-        # DataFrame result
+        >>> data.groupby(func, axis=0).mean()
         >>> data.groupby(['col1', 'col2'])['col3'].mean()
 
-        # DataFrame with hierarchical index
+        DataFrame with hierarchical index
+
         >>> data.groupby(['col1', 'col2']).mean()
 
         Returns