update README with configuration instructions

Author: alexandresalome

README.rst

@@ -1,31 +1,58 @@
 Gitonomy browser
 ================
 
+Gitonomy browser is a handy tool to visualize your local git repositories.
+
+It's still a work in progress, feel free to `contribute on github`_.
+
+Built with `Silex`_ and `gitlib`_ (PHP).
+
 Installation
-------------
+............
+
+To install project, you first need to clone is using ``git``. When project is
+cloned, you will need to configure it. To do so, go to ``config`` folder and
+copy distributed files:
 
 .. code-block:: bash
 
-    git clone [email protected]:gitonomy/browser.git /path/to/install
-    cd /path/to/install
-    cp config_dist.php config.php
+    git clone [email protected]:gitonomy/browser.git gitonomy-browser
+    cd gitonomy-browser/config
+    cp dev.php-dist dev.php
+    cp prod.php-dist prod.php
+
+Edit ``prod.php`` and configure where your git repositories are located. You
+can configure it in 3 different ways.
 
-Edit ``config.php`` and modify array to return instances of ``Repository`` objects on each of your projects:
+First way to configure is to give an exhaustive list of repositories you want:
 
 .. code-block:: php
 
-    <?php return array(
-        'symfony' => new Gitonomy\Browser\Git\Repository('/var/www/symfony'),
-        'silex' => new Gitonomy\Browser\Git\Repository('/var/www/silex'),
-        'twig' => new Gitonomy\Browser\Git\Repository('/var/www/twig'),
+    <?php # prod.php
+
+    $app['repositories'] = array(
+        'foobar' => new Gitonomy\Git\Repository('/var/www/foobar'),
+        'barbaz' => new Gitonomy\Git\Repository('/var/www/barbaz'),
     );
 
-You can also map to bare repositories.
+The second way is to use recursive function to detect repositories. It's very
+useful if you have multi-level folders:
+
+.. code-block:: php
+
+    <?php # prod.php
+
+    $app['repositories'] = ';
+
 
-When you have filled the file, launch `composer`_ to fetch dependencies and make project workable:
+When you have filled it, launch `composer`_ to fetch dependencies and make
+project workable:
 
 .. code-block:: bash
 
     php composer.phar install
 
 .. _composer: http://packagist.org
+.. _silex: http://silex.sensiolabs.org/
+.. _gitlib: https://github.com/gitonomy/gitlib
+.. _contribute on github: https://help.github.com/articles/fork-a-repo