Improve front page

git-svn-id: https://scikit-learn.svn.sourceforge.net/svnroot/scikit-learn/trunk@685 22fbfee3-77ab-4535-9bad-27d1bd3bc7d8

doc/index.rst

@@ -30,15 +30,18 @@
 Scikits.learn Documentation
 ===========================
 
-Introduction
-============
-``scikits.learn`` is a Python module for machine learning. It aims to
-implement classic machine learning algorithms while remaining simple
-and efficient.
+.. topic:: Easy-to-use and general-purpose machine learning in Python
 
-It implements several machine learning algorithms, including Support
-Vector Machines, Gaussian Mixture Models, Neural Networks, Nearest
-Neighbors, Generalized Linear Models, etc.
+    ``scikits.learn`` is a Python module integrating classique machine
+    learning algorithmes in the tightly-nit world of scientific Python
+    packages (`numpy <http://www.scipy.org>`_, `scipy
+    <http://www.scipy.org>`_, `matplotlib
+    <http://matplotlib.sourceforge.net/>`_).
+    
+    It aims to provide simple and efficient solutions to learning
+    problems that are accessible to everybody and reusable in various
+    contexts: **machine-learning as a versatile tool for science and
+    engineering**.
     
 .. image:: auto_examples/images/plot_digits_classification.png
     :align: right
@@ -49,7 +52,7 @@ Neighbors, Generalized Linear Models, etc.
 
     <small>
 
-**Example**::
+:ref:`A simple Example: recognizing hand-written digits <example_plot_digits_classification.py>` ::
 
     import pylab as pl
 
@@ -76,7 +79,16 @@ Neighbors, Generalized Linear Models, etc.
     </small>
 
 
-User guide: contents
+**Features:**
+
+ * **Solid**: supervised learning: classification, regression
+
+ * **Work in progress**: unsupervised learning: clustering, mixture modeling,
+   manifold learning
+
+ * **Planed**: Gaussian graphical models, matrix factorization, ICA
+
+User guide
 ======================
 
 .. toctree::

doc/install.rst

-Installing
-============
+Installing the `scikit.learn`
+===============================
 
 Binary Packages
 ---------------

doc/sphinxext/gen_rst.py

@@ -32,7 +32,7 @@ rst_template = """
 
 plot_rst_template = """
 
-.. %(short_fname)s_example:
+.. _example_%(fname)s:
 
 %(docstring)s