DOC: Update pandas.DataFrame.tail docstring (pandas-dev#20225)

harisbal · Mar 11, 2018 · fbebc7f · fbebc7f
1 parent c2864d7
commit fbebc7f
Showing 1 changed file with 6 additions and 2 deletions.
diff --git a/pandas/core/generic.py b/pandas/core/generic.py
@@ -3664,7 +3664,11 @@ def head(self, n=5):
 
     def tail(self, n=5):
         """
-        Return the last n rows.
+        Return the last `n` rows.
+
+        This function returns last `n` rows from the object based on
+        position. It is useful for quickly verifying data, for example,
+        after sorting or appending rows.
 
         Parameters
         ----------
@@ -3706,7 +3710,7 @@ def tail(self, n=5):
         7   whale
         8   zebra
 
-        Viewing the last n lines (three in this case)
+        Viewing the last `n` lines (three in this case)
 
         >>> df.tail(3)
           animal