DOC: Adding example and See also to head and tail method (pandas-dev#16416)

Author: Cheukting

pandas/core/generic.py

@@ -3570,33 +3570,35 @@ def head(self, n=5):
 
         Examples
         --------
-        >>> df = pd.DataFrame({'animal':['bear', 'bee', 'falcon',
-        ...                   'lion', 'monkey', 'parrot', 'shark']})
+        >>> df = pd.DataFrame({'animal':['alligator', 'bee', 'falcon', 'lion',
+        ...                    'monkey', 'parrot', 'shark', 'whale', 'zebra']})
         >>> df
-           animal
-        0    bear
-        1     bee
-        2  falcon
-        3    lion
-        4  monkey
-        5  parrot
-        6   shark
+              animal
+        0  alligator
+        1        bee
+        2     falcon
+        3       lion
+        4     monkey
+        5     parrot
+        6      shark
+        7      whale
+        8      zebra
 
         Viewing the first 5 lines
         >>> df.head()
-           animal
-        0    bear
-        1     bee
-        2  falcon
-        3    lion
-        4  monkey
+              animal
+        0  alligator
+        1        bee
+        2     falcon
+        3       lion
+        4     monkey
 
         Viewing the first n lines (three in this case)
         >>> df.head(3)
-           animal
-        0    bear
-        1     bee
-        2  falcon
+              animal
+        0  alligator
+        1        bee
+        2     falcon
         """
 
         return self.iloc[:n]
@@ -3624,31 +3626,32 @@ def tail(self, n=5):
         >>> df = pd.DataFrame({'animal':['falcon', 'parrot', 'lion',
         ...                   'monkey', 'shark', 'bee', 'bear']})
         >>> df
-           animal
-        0    bear
-        1     bee
-        2  falcon
-        3    lion
-        4  monkey
-        5  parrot
-        6   shark
+              animal
+        0  alligator
+        1        bee
+        2     falcon
+        3       lion
+        4     monkey
+        5     parrot
+        6      shark
+        7      whale
+        8      zebra
 
         Viewing the last 5 lines
         >>> df.tail()
            animal
-        2  falcon
-        3    lion
         4  monkey
         5  parrot
         6   shark
+        7   whale
+        8   zebra
 
         Viewing the last n lines (three in this case)
         >>> df.tail(3)
-           animal
-        4  monkey
-        5  parrot
-        6   shark
-
+          animal
+        6  shark
+        7  whale
+        8  zebra
         """
 
         if n == 0: