Use :doc: to link to inline documents

Author: Jamie Hannaford

doc/index.rst

@@ -26,9 +26,9 @@ This assumes your application's PHP files are located in the same folder as
 ``vendor/``. If your files are located elsewhere, please supply the path to
 ``vendor/autoload.php`` in the require statement above.
 
-Read the `OpenStack Getting Started guide <getting-started-with-openstack.html>`_
-or `Rackspace Getting Started guide <getting-started-with-rackspace.html>`_ to help
-you get started with basic Compute operations.
+Read the :doc:`getting-started-with-openstack` or
+:doc:`getting-started-with-rackspace` to help you get started with basic
+Compute operations.
 
 Services
 --------

doc/services/identity/roles.rst

@@ -36,6 +36,7 @@ This call lists the global roles available within a specified service.
      // ...
   }
 
+
 Get role
 --------
 

doc/services/identity/tokens.rst

@@ -76,7 +76,7 @@ Interacting with users
   $user = $service->resource('User', $data);
 
 To see which methods you can call on ``$user`` (which implements
-``OpenCloud\Identity\Resource\User``), see our `user documentation <users>`_
+``OpenCloud\Identity\Resource\User``), see our :doc:`user documentation <users>`
 which accompanies this guide.
 
 
@@ -89,7 +89,7 @@ Interacting with tenants
   $tenant = $service->resource('Tenant', $data);
 
 To see which methods you can call on ``$tenant`` (which implements
-``OpenCloud\Identity\Resource\Tenant``), see our `user documentation <tenant>`_
+``OpenCloud\Identity\Resource\Tenant``), see our :doc:`user documentation <tenant>`
 which accompanies this guide.