diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..b46f41f
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,71 @@
+
+==================================
+ETCD Formula
+==================================
+
+Service etcd description
+
+Sample pillars
+==============
+
+Single etcd service
+---------------------
+
+.. code-block:: yaml
+
+    etcd:
+      server:
+        enabled: true
+        bind:
+          host: 10.0.175.101
+        token: $(uuidgen) 
+        members:
+        - host: 10.0.175.101
+          name: etcd01
+          port: 4001
+
+Cluster etcd service
+----------------------
+
+.. code-block:: yaml
+
+    etcd:
+      server:
+        enabled: true
+        bind:
+          host: 10.0.175.101
+        token: $(uuidgen)
+        members:
+        - host: 10.0.175.101
+          name: etcd01
+          port: 4001
+        - host: 10.0.175.102
+          name: etcd02
+          port: 4001
+        - host: 10.0.175.103
+          name: etcd03
+          port: 4001
+
+ETCD proxy
+-------------
+
+.. code-block:: yaml
+
+    etcd:
+      server:
+        enabled: true
+        bind:
+          host: 10.0.175.101
+        proxy: on
+        members:
+        - host: 10.0.175.101
+          name: etcd01
+        - host: 10.0.175.102
+          name: etcd02
+        - host: 10.0.175.103
+          name: etcd03
+
+Read more
+=========
+
+* links