Add more documentation to Series.map()

Author: manuels

pandas/core/series.py

@@ -2121,13 +2121,17 @@ def map(self, arg, na_action=None):
         Examples
         --------
 
-        Map inputs to outputs
+        >>> import pandas as pd
+
+        Map inputs to outputs (both of type `Series`)
 
+        >>> x = pd.Series([1,2,3], index=['one', 'two', 'three'])
         >>> x
         one   1
         two   2
         three 3
 
+        >>> y = pd.Series(['foo', 'bar', 'baz'], index=[1,2,3])
         >>> y
         1  foo
         2  bar
@@ -2138,8 +2142,9 @@ def map(self, arg, na_action=None):
         two   bar
         three baz
 
-        >>> z
-        {1: 'A', 2: 'B', 3: 'C'}
+        Mapping a dictionary keys on the index labels works similar as with a `Series`:
+
+        >>> z = {1: 'A', 2: 'B', 3: 'C'}
 
         >>> x.map(z)
         one   A