Initial commit
diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..b6a07f4
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,70 @@
+======================
+Memcached cache server
+======================
+
+Install and configure Memcached server
+
+Available states
+================
+
+.. contents::
+ :local:
+
+``memcached.server``
+--------------------
+
+Setup Memcached server
+
+Available metadata
+==================
+
+.. contents::
+ :local:
+
+``metadata.memcached.server.single``
+------------------------------------
+
+Single memcached server
+
+``metadata.memcached.server.local``
+-----------------------------------
+
+Memcached server listening on localhost only
+
+Configuration parameters
+========================
+
+
+Example reclass
+===============
+
+Single node memcached service, default parameters but modified cache size.
+
+.. code-block:: yaml
+
+ classes:
+ - service.memcached.server.single
+
+ parameters:
+ memcached:
+ server:
+ cache_size: 64
+
+Sample pillar
+=============
+
+.. code-block:: yaml
+
+ memcached:
+ server:
+ enabled: true
+ cache_size: 64
+ bind:
+ address: 0.0.0.0
+ port: 11211
+ protocol: tcp
+
+Read more
+=========
+
+* http://memcached.org/