diff --git a/api-quick-start/source/api-quick-start.rst b/api-quick-start/source/api-quick-start.rst
index 984567980..a581ba5e8 100644
--- a/api-quick-start/source/api-quick-start.rst
+++ b/api-quick-start/source/api-quick-start.rst
@@ -580,7 +580,7 @@ interface. Also, each OpenStack project has a related client project that
includes Python API bindings and a command-line interface (CLI).
For information about the command-line clients, see `OpenStack
-Command-Line Interface Reference `__.
+Command-Line Interface Reference `__.
Install the clients
-------------------
@@ -625,7 +625,7 @@ Before you can issue client commands, you must download and source the
For complete information about the OpenStack clients, including how to source
the ``openrc`` file, see `OpenStack End User Guide `__,
`OpenStack Admin User Guide `__,
-and `OpenStack Command-Line Interface Reference `__.
+and `OpenStack Command-Line Interface Reference `__.
Launch an instance
------------------
diff --git a/api-ref/src/wadls/identity-api/src/v2.0/wadl/identity-admin.wadl b/api-ref/src/wadls/identity-api/src/v2.0/wadl/identity-admin.wadl
index dff5f12bc..d12a91dbf 100644
--- a/api-ref/src/wadls/identity-api/src/v2.0/wadl/identity-admin.wadl
+++ b/api-ref/src/wadls/identity-api/src/v2.0/wadl/identity-admin.wadl
@@ -702,7 +702,7 @@
The openstack
+ xlink:href="http://docs.openstack.org/cli-reference/openstack.html#openstack-user-show">openstack
user show command supports showing user details by name
or ID. However, the command actually looks up the user ID for
a user name and queries the user by ID.
diff --git a/firstapp/source/block_storage.rst b/firstapp/source/block_storage.rst
index cc93efd21..b30a4338e 100644
--- a/firstapp/source/block_storage.rst
+++ b/firstapp/source/block_storage.rst
@@ -272,11 +272,12 @@ SDKs do not generally support the service yet, but you can use the
'trove' command-line client to work with it instead.
To install the 'trove' command-line client, see
-`Install the OpenStack command-line clients `_.
+`Install the OpenStack command-line clients
+`_.
To set up environment variables for your cloud in an :file:`openrc.sh`
file, see
-`Set environment variables using the OpenStack RC file `_.
+`Set environment variables using the OpenStack RC file `_.
Ensure you have an :file:`openrc.sh` file, source it, and validate that
your trove client works: ::
diff --git a/firstapp/source/networking.rst b/firstapp/source/networking.rst
index 94c1c3349..84c48bf1c 100644
--- a/firstapp/source/networking.rst
+++ b/firstapp/source/networking.rst
@@ -67,10 +67,11 @@ Because the SDKs do not fully support the OpenStack Networking API, this
section uses the command-line clients.
Use this guide to install the 'neutron' command-line client:
-http://docs.openstack.org/cli-reference/content/install_clients.html
+http://docs.openstack.org/cli-reference/common/cli_install_openstack_command_line_clients.html#install-the-clients
-Use this guide to set up the necessary variables for your cloud in an 'openrc' file:
-http://docs.openstack.org/cli-reference/content/cli_openrc.html
+Use this guide to set up the necessary variables for your cloud in an
+'openrc' file:
+http://docs.openstack.org/cli-reference/common/cli_set_environment_variables_using_openstack_rc.html
Ensure you have an openrc.sh file, source it, and then check that your
neutron client works: ::
diff --git a/firstapp/source/orchestration.rst b/firstapp/source/orchestration.rst
index 93bf2d289..b510629e4 100644
--- a/firstapp/source/orchestration.rst
+++ b/firstapp/source/orchestration.rst
@@ -46,10 +46,11 @@ OpenStack. In this section, you use the 'heat' command-line client to access
the Orchestration API directly through template files.
Install the 'heat' command-line client by following this guide:
-http://docs.openstack.org/cli-reference/content/install_clients.html
+http://docs.openstack.org/cli-reference/common/cli_install_openstack_command_line_clients.html#install-the-clients
-Use this guide to set up the necessary variables for your cloud in an 'openrc' file:
-http://docs.openstack.org/cli-reference/content/cli_openrc.html
+Use this guide to set up the necessary variables for your cloud in an
+'openrc' file:
+http://docs.openstack.org/cli-reference/common/cli_set_environment_variables_using_openstack_rc.html
.. only:: dotnet
@@ -206,12 +207,12 @@ The example template depends on the ceilometer project, which is part of the
To better understand how the template works, use this guide to install the
'ceilometer' command-line client:
-* http://docs.openstack.org/cli-reference/content/install_clients.html
+* http://docs.openstack.org/cli-reference/common/cli_install_openstack_command_line_clients.html#install-the-clients
To set up the necessary variables for your cloud in an 'openrc' file, use this
guide:
-* http://docs.openstack.org/cli-reference/content/cli_openrc.html
+* http://docs.openstack.org/cli-reference/common/cli_set_environment_variables_using_openstack_rc.html
The Telemetry service uses meters to measure a given aspect of a resources
usage. The meter that we are interested in is the :code:`cpu_util` meter.
diff --git a/www/index.html b/www/index.html
index 02c8659b8..f101acb4f 100644
--- a/www/index.html
+++ b/www/index.html
@@ -758,7 +758,7 @@