Reordered doc-string sections for combine & combine_first

Followed link : https://numpydoc.readthedocs.io/en/latest/format.html#sections

Author: tm9k1

pandas/core/series.py

@@ -2308,6 +2308,11 @@ def combine(self, other, func, fill_value=None):
         Series
             The result of combining the Series with the other object.
 
+        See Also
+        --------
+        Series.combine_first : Combine Series values, choosing the calling
+                               Series' values first.
+
         Examples
         --------
         >>> s1 = pd.Series([1, 2])
@@ -2331,11 +2336,6 @@ def combine(self, other, func, fill_value=None):
         2    787
         dtype: int64
 
-        See Also
-        --------
-        Series.combine_first : Combine Series values, choosing the calling
-                               Series' values first.
-
         """
         if fill_value is None:
             fill_value = na_value_for_dtype(self.dtype, compat=False)
@@ -2387,16 +2387,7 @@ def combine_first(self, other):
         Returns
         -------
         combined : Series
-
-        Examples
-        --------
-        >>> s1 = pd.Series([1, np.nan])
-        >>> s2 = pd.Series([3, 4])
-        >>> s1.combine_first(s2)
-        0    1.0
-        1    4.0
-        dtype: float64
-
+        
         See Also
         --------
         Series.combine : Perform elementwise operation on two Series
@@ -2406,6 +2397,15 @@ def combine_first(self, other):
         -----
         Result index will be the union of the two indexes.
 
+        Examples
+        --------
+        >>> s1 = pd.Series([1, np.nan])
+        >>> s2 = pd.Series([3, 4])
+        >>> s1.combine_first(s2)
+        0    1.0
+        1    4.0
+        dtype: float64
+        
         """
         new_index = self.index.union(other.index)
         this = self.reindex(new_index, copy=False)