first commit
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