Added docs for installation and running tests

Change-Id: I2fef8374ff8efe9fcb5588de0c312f87f6a803e4

CONTRIBUTING.rst

@@ -14,4 +14,4 @@ Pull requests submitted through GitHub will be ignored.
 
 Bugs should be filed on Launchpad, not GitHub:
 
-   https://bugs.launchpad.net/zaqar_tempest_plugin
+   https://bugs.launchpad.net/zaqar

README.rst

@@ -10,3 +10,15 @@ It contains the tempest plugin for the functional testing of Zaqar Project.
 * Documentation: http://docs.openstack.org/developer/zaqar
 * Source: http://git.openstack.org/cgit/openstack/zaqar-tempest-plugin
 * Bugs: http://bugs.launchpad.net/zaqar
+
+Running the tests
+-----------------
+
+To run all tests from this plugin, install Zaqar into your environment
+and from the tempest repo, run::
+
+    $ tox -e all-plugin -- zaqar_tempest_tests
+
+To run all tempest tests including this plugin, run::
+
+    $ tox -e all-plugin

doc/source/installation.rst

@@ -2,11 +2,12 @@
 Installation
 ============
 
+Tempest automatically discovers installed plugins. That's why you just need
+to install the Python packages that contains the Zaqar Tempest plugin in
+the same environment where Tempest is installed.
+
 At the command line::
 
-    $ pip install openstack
-
-Or, if you have virtualenvwrapper installed::
-
-    $ mkvirtualenv openstack
-    $ pip install openstack
+    $ git clone https://git.openstack.org/openstack/zaqar-tempest-plugin
+    $ cd zaqar-tempest-plugin/
+    $ pip install zaqar-tempest-plugin