updated docs for pandas.Series.str.find

pandas/core/strings.py

@@ -1771,6 +1771,8 @@ def extractall(self, pat, flags=0):
         return str_extractall(self._orig, pat, flags=flags)
 
     _shared_docs['find'] = ("""
+    Retrieves least index of substring.
+
     Return %(side)s indexes in each strings in the Series/Index
     where the substring is fully contained between [start:end].
     Return -1 on failure. Equivalent to standard :meth:`str.%(method)s`.
@@ -1788,6 +1790,19 @@ def extractall(self, pat, flags=0):
     -------
     found : Series/Index of integer values
 
+    Examples
+    --------
+    >>> s = Series('Finding with pandas')
+    >>> s.str.find('wi')
+    0    8
+    dtype: int64
+
+    Returns -1 if the substring is not found in S
+
+    >>> s.str.find('wi', start=0, end=5)
+    0   -1
+    dtype: int64
+
     See Also
     --------
     %(also)s