Make Series.map() documentation a bit more verbose

Author: manuels

pandas/core/series.py

@@ -2138,6 +2138,14 @@ def map(self, arg, na_action=None):
         two   bar
         three baz
 
+        >>> z
+        {1: 'A', 2: 'B', 3: 'C'}
+
+        >>> x.map(z)
+        one   A
+        two   B
+        three C
+
         Use na_action to control whether NA values are affected by the mapping
         function.
 
@@ -2159,6 +2167,9 @@ def map(self, arg, na_action=None):
         3                     NaN
         dtype: object
 
+        See also
+        --------
+        Series.apply: For applying more complex functions on a Series
         """
 
         if is_extension_type(self.dtype):