Improve documentation

README.rst

 Yet one More Raster library
 ===========================
 
-The ``ymraster`` package contains tools for manipulating raster images.
+The ``ymraster`` package contains tools for:
+
+* manipulating raster images,
+* perform classifications on these images.
 
 For example, you can simply create a ``Raster`` instance and compute the NDVI
-with the following two commands.
+with the following simple commands.
 
+>>> from ymraster import Raster
 >>> raster = Raster('data/l8_20130425.tif')
 >>> ndvi = raster.ndvi('l8_20130425_ndvi.tif', idx_red=4, idx_nir=5)
 
@@ -22,6 +26,7 @@ You need to have the following tools installed and properly set up:
   raster computations,
 * `GDAL <http://gdal.org/>`_ for reading and writing rasters,
 * `NumPy <http://www.numpy.org/>`_ for matrix & numeric computations,
+* `scikit-learn <http://scikit-learn.org/>`_ for classifications.
 
 Surely, there are already binary packages for these tools for your Linux
 distribution.
@@ -37,18 +42,16 @@ environment::
 Installation
 ````````````
 
-Simple clone the repository in a folder of your choice::
+Simply clone the repository in a folder of your choice::
 
         $ cd </path/to/folder>  # eg. ~/.local/opt
         $ git clone https://github.com/ygversil/ymraster.git
 
-Then create a .pth file in your ``site-packages`` folder with the path to the
-folder.::
+Then install this into your environment.::
 
-        $ cd /.local/lib/python2.7/site-pakcages  # create directory if it does not exists
-        $ echo "/home/<user>/local/opt/ymraster" > ymraster.pth
+        $ cd ymraster
+        $ pip install -e [--user] ./
 
 Now you can import ``ymraster`` in Python.
 
 >>> import ymraster
->>>

doc/index.rst

@@ -13,8 +13,8 @@
 .. include:: ../README.rst
 
 
-The ``Raster`` class
-====================
+The ``ymraster`` module
+=======================
 
 .. automodule:: ymraster.ymraster
    :members: