diff --git a/rally-jobs/README.rst b/rally-jobs/README.rst
new file mode 100644
index 0000000000..fc822c8f8d
--- /dev/null
+++ b/rally-jobs/README.rst
@@ -0,0 +1,30 @@
+Rally job related files
+=======================
+
+This directory contains rally tasks and plugins that are run by OpenStack CI.
+
+Structure
+---------
+
+* plugins - directory where you can add rally plugins. Almost everything in
+  Rally is a plugin. Benchmark context, Benchmark scenario, SLA checks, Generic
+  cleanup resources, ....
+
+* extra - all files from this directory will be copy pasted to gates, so you
+  are able to use absolute paths in rally tasks.
+  Files will be located in ~/.rally/extra/*
+
+* glance.yaml is a task that is run in gates against OpenStack (nova network)
+  deployed by DevStack
+
+
+Useful links
+------------
+
+* More about Rally: https://rally.readthedocs.org/en/latest/
+
+* How to add rally-gates: https://rally.readthedocs.org/en/latest/rally_gatejob.html
+
+* About plugins:  https://rally.readthedocs.org/en/latest/plugins.html
+
+* Plugin samples: https://github.com/stackforge/rally/tree/master/doc/samples/plugins
\ No newline at end of file
diff --git a/rally-jobs/extra/README.rst b/rally-jobs/extra/README.rst
new file mode 100644
index 0000000000..836f35a027
--- /dev/null
+++ b/rally-jobs/extra/README.rst
@@ -0,0 +1,5 @@
+Extra files
+===========
+
+All files from this directory will be copy pasted to gates, so you are able to
+use absolute path in rally tasks. Files will be in ~/.rally/extra/*
diff --git a/rally-scenarios/extra/fake.img b/rally-jobs/extra/fake.img
similarity index 100%
rename from rally-scenarios/extra/fake.img
rename to rally-jobs/extra/fake.img
diff --git a/rally-scenarios/glance.yaml b/rally-jobs/glance.yaml
similarity index 100%
rename from rally-scenarios/glance.yaml
rename to rally-jobs/glance.yaml
diff --git a/rally-jobs/plugins/README.rst b/rally-jobs/plugins/README.rst
new file mode 100644
index 0000000000..9b98924069
--- /dev/null
+++ b/rally-jobs/plugins/README.rst
@@ -0,0 +1,9 @@
+Rally plugins
+=============
+
+All *.py modules from this directory will be auto-loaded by Rally and all
+plugins will be discoverable. There is no need of any extra configuration
+and there is no difference between writing them here and in rally code base.
+
+Note that it is better to push all interesting and useful benchmarks to Rally
+code base, this simplifies administration for Operators.
\ No newline at end of file
diff --git a/rally-scenarios/plugins/plugin_sample.py b/rally-jobs/plugins/plugin_sample.py
similarity index 100%
rename from rally-scenarios/plugins/plugin_sample.py
rename to rally-jobs/plugins/plugin_sample.py
diff --git a/rally-scenarios/README.rst b/rally-scenarios/README.rst
deleted file mode 100644
index e547274701..0000000000
--- a/rally-scenarios/README.rst
+++ /dev/null
@@ -1,13 +0,0 @@
-This directory contains rally benchmark scenarios to be run by OpenStack CI.
-
-Structure:
-* glance.yaml is rally task that will be run in gates
-* plugins - directory where you can add rally plugins. So you don't need
-  to merge benchmark in scenarios in rally to be able to run them in glance.
-* extra - all files from this directory will be copy pasted to gets, so you
-  are able to use absolute path in rally tasks. Files will be in ~/.rally/extra/*
-
-
-* more about rally: https://wiki.openstack.org/wiki/Rally
-* how to add rally-gates: https://wiki.openstack.org/wiki/Rally/RallyGates
-* how to write plugins https://rally.readthedocs.org/en/latest/plugins.html