diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..0ad9faf
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,40 @@
+
+==================================
+zookeeper
+==================================
+
+Service zookeeper description
+
+Sample pillars
+==============
+
+Single zookeeper service
+
+.. code-block:: yaml
+
+    zookeeper:
+      server:
+        enabled: true
+        members:
+        - host: ${_param:single_address}
+          id: 1
+
+Cluster zookeeper service
+
+.. code-block:: yaml
+
+    zookeeper:
+      server:
+        enabled: true
+        members:
+        - host: ${_param:cluster_node01_address}
+          id: 1
+        - host: ${_param:cluster_node02_address}
+          id: 2
+        - host: ${_param:cluster_node03_address}
+          id: 3
+
+Read more
+=========
+
+* links