DOC: update the Index.shift docstring (pandas-dev#20192)

* DOC: updating docstring of Index.shift

* Add See Also section to shift

* Update link to Series.shift

Author: DataOmbudsman

pandas/core/indexes/base.py

@@ -2256,18 +2256,19 @@ def sortlevel(self, level=None, ascending=True, sort_remaining=None):
         return self.sort_values(return_indexer=True, ascending=ascending)
 
     def shift(self, periods=1, freq=None):
-        """Shift index by desired number of time frequency increments.
+        """
+        Shift index by desired number of time frequency increments.
 
         This method is for shifting the values of datetime-like indexes
         by a specified time increment a given number of times.
 
         Parameters
         ----------
-        periods : int
+        periods : int, default 1
             Number of periods (or increments) to shift by,
-            can be positive or negative (default is 1).
-        freq : pandas.DateOffset, pandas.Timedelta or string
-            Frequency increment to shift by (default is None).
+            can be positive or negative.
+        freq : pandas.DateOffset, pandas.Timedelta or string, optional
+            Frequency increment to shift by.
             If None, the index is shifted by its own `freq` attribute.
             Offset aliases are valid strings, e.g., 'D', 'W', 'M' etc.
 
@@ -2276,6 +2277,10 @@ def shift(self, periods=1, freq=None):
         pandas.Index
             shifted index
 
+        See Also
+        --------
+        Series.shift : Shift values of Series.
+
         Examples
         --------
         Put the first 5 month starts of 2011 into an index.