DOC: Updating Series.autocorr docstring

pandas/core/series.py

@@ -2021,7 +2021,10 @@ def diff(self, periods=1):
 
     def autocorr(self, lag=1):
         """
-        Lag-N autocorrelation
+        Compute the lag-N autocorrelation.
+
+        This method computes the pearson correlation between
+        the Series and its shifted self.
 
         Parameters
         ----------
@@ -2030,7 +2033,36 @@ def autocorr(self, lag=1):
 
         Returns
         -------
-        autocorr : float
+        float
+            The pearson correlation between self and self.shift(lag).
+
+        See Also
+        --------
+        Series.corr : Compute the correlation between two Series.
+        Series.shift : Shift index by desired number of periods.
+        DataFrame.corr : Compute pairwise correlation of columns.
+        DataFrame.corrwith : Compute pairwise correlation between rows or
+            columns of two DataFrame objects.
+
+        Notes
+        -----
+        If the pearson correlation is not well defined return 'NaN'.
+
+        Examples
+        --------
+        >>> s = pd.Series([0.25, 0.5, 0.2, -0.05])
+        >>> s.autocorr()
+        0.1035526330902407
+        >>> s.autocorr(lag=2)
+        -0.9999999999999999
+
+        **Warning**
+
+        If the pearson correlation is not well defined, then 'NaN' is returned.
+
+        >>> s = pd.Series([1, 0, 0, 0])
+        >>> s.autocorr()
+        nan
         """
         return self.corr(self.shift(lag))