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,33 @@ 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.
+
+        Notes
+        -----
+        return Nan if the computation of the autocorr is not possible.
+
+        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 between self and self.shift(lag) cannot be
+        computed, then nan is returned.
+
+        >>> s = pd.Series([1, 0, 0, 0])
+        >>> s.autocorr()
+        nan
         """
         return self.corr(self.shift(lag))