diff --git a/README.rst b/README.rst
index 12e2e5b6..4b3dbf1c 100644
--- a/README.rst
+++ b/README.rst
@@ -1,4 +1,34 @@
 MSMTools
 ========
 
-desc
+What is it?
+-----------
+msmtools is an open source collection of algorithms for the estimation
+and analysis of discrete state space Markov chains via Markov state
+models (MSM).
+
+The algorithms are implemented using `NumPy <http://www.numpy.org/>`_
+and `SciPy <http://www.scipy.org>`_.
+
+Installation
+------------
+With pip::
+ 
+     pip install msmtools
+
+with conda::
+
+     conda install -c https://conda.binstar.org/omnia msmtools
+
+
+or install latest devel branch with pip::
+
+     pip install git+https://github.com/markovmodel/msmtools.git@devel
+     
+
+Support and development
+-----------------------
+For bug reports/sugguestions/complains please file an issue on 
+`GitHub <http://github.com/markovmodel/msmtools>`__.
+
+Or start a discussion on our mailing list: pyemma-users@lists.fu-berlin.de