diff --git a/doc/source/developing_guides/rally_on_gates.rst b/doc/source/developing_guides/rally_on_gates.rst
index 59d0dd1a23..ab87235d08 100644
--- a/doc/source/developing_guides/rally_on_gates.rst
+++ b/doc/source/developing_guides/rally_on_gates.rst
@@ -71,8 +71,7 @@ placed in ``rally-scenarios/extra/`` directory.
 
 Also it's possible to specify other fields for each Rally task, like ``sla``
 or ``context``. More information about other configuration setting is
-available by link https://rally.readthedocs.org/en/latest/tutorial.html
-
+available by link https://rally.readthedocs.io/en/latest/plugins/#rally-plugins
 Mentioned patch was proposed for confirmation caching mechanism of Heat
 template validation process
 (see https://specs.openstack.org/openstack/heat-specs/specs/liberty/constraint-validation-cache.html).
diff --git a/rally-scenarios/README.rst b/rally-scenarios/README.rst
index 40512c9f12..c736d52efb 100644
--- a/rally-scenarios/README.rst
+++ b/rally-scenarios/README.rst
@@ -10,4 +10,4 @@ Structure:
 
 * 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
+* how to write plugins https://rally.readthedocs.io/en/latest/plugins/#rally-plugins
diff --git a/rally-scenarios/plugins/sample_plugin.py b/rally-scenarios/plugins/sample_plugin.py
index 7f20f0f2f3..fd541cf023 100644
--- a/rally-scenarios/plugins/sample_plugin.py
+++ b/rally-scenarios/plugins/sample_plugin.py
@@ -18,7 +18,7 @@
 For more Heat related benchmarks take a look here:
 https://git.openstack.org/cgit/openstack/rally/tree/rally/plugins/openstack/scenarios/heat
 
-About plugins: https://rally.readthedocs.org/en/latest/plugins.html
+About plugins: https://rally.readthedocs.io/en/latest/plugins/#rally-plugins
 
 Rally concepts https://wiki.openstack.org/wiki/Rally/Concepts
 """