diff --git a/README.md b/README.md
index 2fc7a40..d15ba6a 100644
--- a/README.md
+++ b/README.md
@@ -1,8 +1,26 @@
-## SolrCloud-formula
-A saltstack formula to installl and configure the SolrCloud with ZooKeeper
->Note:
-This formula only manages Solr and ZooKeeper You are responsible for installing/configuring Java as appropriate.
-This formula should definetely works on any Linux platform as soon as it is not depends on any platform dependent features. Tested to work fine on Debian Jessie.
+======
+Solr
+======
+
+[![Build Status](https://travis-ci.org/saltstack-formula/solr-formula.svg?branch=master)](https://travis-ci.org/saltstack-formula/solr-formula)
+
+Formula to set up and configure solr
+
+.. note::
+
+    See the full `Salt Formulas installation and usage instructions
+    <http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.
+
+Available states
+================
+
+.. contents::
+    :local:
+
+``solr``
+----------
+
+Installs Solr and starts the service.
 
 Example top.sls:
 ```