make md2rst

Makefile

@@ -85,3 +85,7 @@ dist: clean ## builds source and wheel package
 
 install: clean ## install the package to the active Python's site-packages
 	python setup.py install
+
+md2rst:
+	pandoc --from=markdown --to=rst --output=README.rst README.md
+

README.md

@@ -15,10 +15,10 @@ Can be easily installed using **pip**:
 pip install carveme
 ```
 
-Additionally, you must install diamond and CPLEX. 
+Additionally, you must install diamond and CPLEX (please check the documentation for details). 
 
 ### Credits and License
 
 Developed at the European Molecular Biology Laboratory (2017).
 
-Released under an Apache License.
+Released under an Apache License.

README.rst

@@ -1,6 +1,38 @@
-=======
+|License| |PyPI version| |Documentation Status|
+
 CarveMe
 =======
 
+CarveMe is a python-based tool for genome-scale metabolic model
+reconstruction.
+
+Documentation
+~~~~~~~~~~~~~
+
+For more details please check: http://carveme.readthedocs.io/
+
+Instalation
+~~~~~~~~~~~
+
+Can be easily installed using **pip**:
+
+::
+
+    pip install carveme
+
+Additionally, you must install diamond and CPLEX (please check the
+documentation for details).
+
+Credits and License
+~~~~~~~~~~~~~~~~~~~
+
+Developed at the European Molecular Biology Laboratory (2017).
 
+Released under an Apache License.
 
+.. |License| image:: https://img.shields.io/badge/License-Apache%202.0-blue.svg
+   :target: https://opensource.org/licenses/Apache-2.0
+.. |PyPI version| image:: https://badge.fury.io/py/carveme.svg
+   :target: https://badge.fury.io/py/carveme
+.. |Documentation Status| image:: http://readthedocs.org/projects/carveme/badge/?version=latest
+   :target: http://carveme.readthedocs.io/en/latest/?badge=latest