DOC:Improve the docstring of DataFrame.iloc()

pandas/core/indexing.py

@@ -1629,7 +1629,8 @@ def _getitem_axis(self, key, axis=None):
 
 
 class _iLocIndexer(_LocationIndexer):
-    """Purely integer-location based indexing for selection by position.
+    """
+    Purely integer-location based indexing for selection by position.
 
     ``.iloc[]`` is primarily integer position based (from ``0`` to
     ``length-1`` of the axis), but may also be used with a boolean
@@ -1648,8 +1649,35 @@ class _iLocIndexer(_LocationIndexer):
     out-of-bounds, except *slice* indexers which allow out-of-bounds
     indexing (this conforms with python/numpy *slice* semantics).
 
-    See more at :ref:`Selection by Position <indexing.integer>`
+    See Also
+    --------
+    DataFrame.ix : A primarily label-location based indexer
+    DataFrame.loc : Fast integer location scalar accessor.
 
+    Examples
+    --------
+    >>> import pandas as pd
+    >>> mydict = [{'a': 1, 'b': 2, 'c': 3, 'd': 4},
+    ...           {'a': 100,  'b': 200, 'c': 300, 'd': 400},
+    ...           {'a': 1000,  'b': 2000,  'c': 3000,  'd': 4000 }]
+    >>> df = pd.DataFrame(mydict)
+    >>> print(df.head())
+          a     b     c     d
+    0     1     2     3     4
+    1   100   200   300   400
+    2  1000  2000  3000  4000
+    >>> print(df.iloc[0])
+    a    1
+    b    2
+    c    3
+    d    4
+    Name: 0, dtype: int64
+    >>> print(df.iloc[0:2])
+         a    b    c    d
+    0        1    2    3    4
+    1  100  200  300  400
+
+    ref:`Selection by Position <indexing.integer>`
     """
 
     _valid_types = ("integer, integer slice (START point is INCLUDED, END "