Add alex-z changes
diff --git a/README.rst b/README.rst
index 09a181e..d3ef0ca 100644
--- a/README.rst
+++ b/README.rst
@@ -1,38 +1,47 @@
cookiecutter-salt-formula
=========================
-A cookiecutter_ template for Salt Formula.
+A cookiecutter template for Salt Formula.
-Usage
+Installation
============
.. code-block:: bash
- cookiecutter cookiecutter-salt-formula
-
-
-Init Kitchen CI
-===============
-
-Install prerequisites.
-- `envtpl` is renders jinja2 templates on the command line with shell environment variables.
-- gems required dpends on driver configured to be used (docker by default)
-
-.. code-block:: bash
-
pip install cookiecutter
- pip install envtpl
- gem install kitchen-docker kitchen-vagrant kitchen-salt kitchen-openstack kitchen-inspec busser-serverspec
-Once you create your `tests/pillar` structure (required if you want to auto populate kitchen test suites)
+ cd cookiecutter
-.. code-block:: bash
+ cookiecutter salt-formula
+
+
+Init Test Kitchen configuration
+===============================
+
+Follow the `salt formula testing <https://salt-formulas.readthedocs.io/en/latest/develop/testing-formulas.html>`_ guidelines and
+automated CI in the main `documentation <https://salt-formulas.readthedocs.io/en/latest/develop/testing.html>`_.
+
+To generate ``.kitchen.yml`` for new or existing project:
+
+- install `envtpl`, renders jinja2 templates with shell environment variables
+- install required gems, it depends on drivers configured to be used (docker by default)
+
+.. code-block:: shell
pip install envtpl
- ./kitchen-init.sh
+ gem install kitchen-docker kitchen-salt [kitchen-openstack kitchen-vagrant kitchen-inspec busser-serverspec]
-Instantly for latest version or on existing formulas:
+Once you create your `tests/pillar` structure (required if you want to auto-populate kitchen yaml with test suites)
-.. code-block:: bash
+.. code-block:: shell
- curl -skL "https://raw.githubusercontent.com/tcpcloud/cookiecutter-salt-formula/master/kitchen-init.sh" | bash -s --
+ # cd <formula repository>
+ ../kitchen-init.sh
+
+Instantly, to add kitchen configuration into existing repository:
+
+.. code-block:: shell
+
+ # cd <formula repository>
+ curl -skL "https://raw.githubusercontent.com/salt-formulas/salt-formulas-cookiecutter/master/salt-formula/kitchen-init.sh" | bash -s --
+