diff --git a/docs/source/conf.py b/docs/source/conf.py
index 60f0fb0..43e5750 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -47,10 +47,11 @@ copyright = u'2013, Mathieu Agopian'
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
-# The short X.Y version.
-version = '0.1dev'
-# The full version, including alpha/beta/rc tags.
-release = '0.1dev'
+
+# read the VERSION file which is three level up
+from os.path import join, dirname, abspath
+with open(join(dirname(dirname(dirname(abspath(__file__)))), 'VERSION')) as f:
+    release = version = f.read()
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
diff --git a/docs/source/index.rst b/docs/source/index.rst
index fa97a25..bcfe910 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -151,6 +151,7 @@ Mails are flagged according to their state, in the ``process_messages`` method:
 
 * unread (unseen): mail to be processed by MailBot
 * read (seen):
+
   - starred (flagged): MailBot is checking callbacks, and triggering them if
     needed, the mail is being processed
   - not starred (unflagged): MailBot is done with this mail, and won't process