diff --git a/README.rst b/README.rst
new file mode 100644
index 0000000..788cf53
--- /dev/null
+++ b/README.rst
@@ -0,0 +1,323 @@
+
+====  
+Salt
+====
+
+Salt is a new approach to infrastructure management. Easy enough to get running in minutes, scalable enough to manage tens of thousands of servers, and fast enough to communicate with them in seconds.
+
+Salt delivers a dynamic communication bus for infrastructures that can be used for orchestration, remote execution, configuration management and much more.
+
+Sample pillars
+==============
+
+Salt master
+-----------
+
+Salt master with base environment and pillar metadata source
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        enabled: true
+        command_timeout: 5
+        worker_threads: 2
+        pillar:
+          engine: salt
+          source:
+            engine: git
+            address: 'git@repo.domain.com:salt/pillar-demo.git'
+            branch: 'master'
+        base_environment: prd
+        environment:
+          prd:
+            enabled: true
+            formula:
+              linux:
+                source: git
+                address: 'git@repo.domain.com:salt/formula-linux.git'
+                branch: 'master'
+              salt:
+                source: git
+                address: 'git@repo.domain.com:salt/formula-salt.git'
+                branch: 'master'
+              openssh:
+                source: git
+                address: 'git@repo.domain.com:salt/formula-openssh.git'
+                branch: 'master'
+
+Simple Salt master with base environment and custom states
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        ...
+        environment:
+          base:
+            states:
+            - name: gitlab
+              source: git
+              address: 'git@repo.domain.cz:salt/state-gitlab.git'
+              branch: 'master'
+            formulas:
+            ...
+
+Salt master with reclass ENC
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        enabled: true
+        ...
+        pillar:
+          engine: reclass
+          data_dir: /srv/salt/reclass
+
+Salt master with windows repository
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        enabled: true
+        ...
+        windows_repo:
+          type: git
+          address: 'git@repo.domain.com:salt/win-packages.git'
+
+Salt master with API
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        ...
+      api:
+        enabled: true
+        port: 8000
+
+Salt master with preset minions
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        enabled: true
+        ...
+        minions:
+        - name: 'node1.system.location.domain.com'
+
+Salt master syndicate master of masters
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        enabled: true
+        ...
+        syndic:
+          mode: master
+
+Salt master syndicate (client) master
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        enabled: true
+        ...
+        syndicate:
+          mode: client
+          host: master-master
+
+Salt master with custom handlers
+
+.. code-block:: yaml
+
+    salt:
+      master:
+        enabled: true
+        command_timeout: 5
+        worker_threads: 2
+        environments:
+        - name: base
+          states:
+          - source: git
+            address: 'git@repo.domain.com:salt/state-ubuntu.git'
+            branch: 'master'
+          pillar:
+            source: git
+            address: 'git@repo.domain.com:salt/pillar-demo.git'
+            branch: 'master'
+        handlers:
+          name: logstash
+          type: udp
+          bind:
+            host: 127.0.0.1
+            port: 9999
+      minion:
+        handlers:
+        - engine: udp
+          bind:
+            host: 127.0.0.1
+            port: 9999
+        - engine: zmq
+          bind:
+            host: 127.0.0.1
+            port: 9999
+
+Salt minion
+-----------
+
+Simplest Salt minion
+
+.. code-block:: yaml
+
+    salt:
+      minion:
+        enabled: true
+        master:
+          host: master.domain.com
+
+Multi-master Salt minion
+
+.. code-block:: yaml
+
+    salt:
+      minion:
+        enabled: true
+        masters:
+        -  host: master1.domain.com
+        -  host: master2.domain.com
+
+Salt minion with salt mine options
+
+    salt:
+      minion:
+        enabled: true
+        master:
+          host: master.domain.com
+        mine:
+          interval: 60
+          module:
+            grains.items: []
+            network.interfaces: []
+
+Salt minion with graphing dependencies
+
+.. code-block:: yaml
+
+    salt:
+      minion:
+        enabled: true
+        graph_states: true
+        master:
+          host: master.domain.com
+
+Salt control (cloud/virt)
+-------------------------
+
+Salt cloud with local OpenStack insecure (ignoring SSL cert errors) provider 
+
+.. code-block:: yaml
+
+    salt:
+      control:
+        enabled: true
+        provider:
+          openstack_account:
+            engine: openstack
+            insecure: true
+            region: RegionOne
+            identity_url: 'https://10.0.0.2:35357'
+            tenant: devops
+            user: user
+            password: 'password'
+            fixed_networks:
+            - 123d3332-18be-4d1d-8d4d-5f5a54456554e
+            floating_networks:
+            - public
+            ignore_cidr: 192.168.0.0/16
+
+Salt cloud with Digital Ocean provider
+
+.. code-block:: yaml
+
+    salt:
+      control:
+        enabled: true
+        provider:
+          dony1:
+            engine: digital_ocean
+            region: New York 1
+            client_key: xxxxxxx
+            api_key: xxxxxxx
+
+Salt cloud with cluster definition
+
+.. code-block:: yaml
+
+    salt:
+      control:
+        enabled: true
+        cluster:
+          devops_ase:
+            config:
+              engine: salt
+              host: 147.32.120.1
+            node:
+              proxy1.ase.cepsos.cz:
+                provider: cepsos_devops
+                image: Ubuntu12.04 x86_64
+                size: m1.medium
+              node1.ase.cepsos.cz:
+                provider: cepsos_devops
+                image: Ubuntu12.04 x86_64
+                size: m1.medium
+              node2.ase.cepsos.cz:
+                provider: cepsos_devops
+                image: Ubuntu12.04 x86_64
+                size: m1.medium
+              node3.ase.cepsos.cz:
+                provider: cepsos_devops
+                image: Ubuntu12.04 x86_64
+                size: m1.medium
+
+Usage
+=====
+
+Working with salt-cloud
+
+.. code-block:: bash
+
+    salt-cloud -m /path/to/map --assume-yes
+
+Debug LIBCLOUD for salt-cloud connection
+
+.. code-block:: bash
+
+    export LIBCLOUD_DEBUG=/dev/stderr; salt-cloud --list-sizes provider_name --log-level all
+
+Read more
+=========
+
+* http://salt.readthedocs.org/en/latest/
+* https://github.com/DanielBryan/salt-state-graph
+* http://karlgrz.com/testing-salt-states-rapidly-with-docker/
+* https://mywushublog.com/2013/03/configuration-management-with-salt-stack/
+* http://russell.ballestrini.net/replace-the-nagios-scheduler-and-nrpe-with-salt-stack/
+* https://github.com/saltstack-formulas/salt-formula
+* http://docs.saltstack.com/en/latest/topics/tutorials/multimaster.html
+
+salt-cloud
+----------
+
+* http://www.blog.sandro-mathys.ch/2013/07/setting-user-password-when-launching.html
+* http://cloudinit.readthedocs.org/en/latest/topics/examples.html
+* http://salt-cloud.readthedocs.org/en/latest/topics/install/index.html
+* http://docs.saltstack.com/topics/cloud/digitalocean.html
+* http://salt-cloud.readthedocs.org/en/latest/topics/rackspace.html
+* http://salt-cloud.readthedocs.org/en/latest/topics/map.html
+* http://docs.saltstack.com/en/latest/topics/tutorials/multimaster.html