diff --git a/docsite/rst/become.rst b/docsite/rst/become.rst
index 42484d9816..4507b19100 100644
--- a/docsite/rst/become.rst
+++ b/docsite/rst/become.rst
@@ -26,8 +26,8 @@ become_method
     at play or task level overrides the default method set in ansible.cfg
 
 
-New ansible_ variables
-----------------------
+New ansible\_ variables
+-----------------------
 Each allows you to set an option per group and/or host
 
 ansible_become
diff --git a/docsite/rst/guide_aws.rst b/docsite/rst/guide_aws.rst
index 97eb0904fe..c4e12eab49 100644
--- a/docsite/rst/guide_aws.rst
+++ b/docsite/rst/guide_aws.rst
@@ -157,7 +157,7 @@ it will be automatically discoverable via a dynamic group like so::
 Using this philosophy can be a great way to keep systems separated by the function they perform.
 
 In this example, if we wanted to define variables that are automatically applied to each machine tagged with the 'class' of 'webserver', 'group_vars'
-in ansible can be used.  See :doc:`splitting_out_vars`.
+in ansible can be used.  See :ref:`splitting_out_vars`.
 
 Similar groups are available for regions and other classifications, and can be similarly assigned variables using the same mechanism.
 
diff --git a/docsite/rst/intro_configuration.rst b/docsite/rst/intro_configuration.rst
index 73d8fd0f0d..368013d7f1 100644
--- a/docsite/rst/intro_configuration.rst
+++ b/docsite/rst/intro_configuration.rst
@@ -264,7 +264,7 @@ This option causes notified handlers to run on a host even if a failure occurs o
 		force_handlers = True
 
 The default is False, meaning that handlers will not run if a failure has occurred on a host.
-This can also be set per play or on the command line. See :doc:`_handlers_and_failure` for more details.
+This can also be set per play or on the command line. See :ref:`handlers_and_failure` for more details.
 
 .. _forks:
 
diff --git a/lib/ansible/utils/module_docs_fragments/cloudstack.py b/lib/ansible/utils/module_docs_fragments/cloudstack.py
index 8d173ea756..2e89178d00 100644
--- a/lib/ansible/utils/module_docs_fragments/cloudstack.py
+++ b/lib/ansible/utils/module_docs_fragments/cloudstack.py
@@ -51,12 +51,12 @@ requirements:
 notes:
   - Ansible uses the C(cs) library's configuration method if credentials are not
     provided by the options C(api_url), C(api_key), C(api_secret).
-    Configuration is read from several locations, in the following order:
+    Configuration is read from several locations, in the following order":"
     - The C(CLOUDSTACK_ENDPOINT), C(CLOUDSTACK_KEY), C(CLOUDSTACK_SECRET) and
-       C(CLOUDSTACK_METHOD) environment variables.
+      C(CLOUDSTACK_METHOD) environment variables.
     - A C(CLOUDSTACK_CONFIG) environment variable pointing to an C(.ini) file,
     - A C(cloudstack.ini) file in the current working directory.
     - A C(.cloudstack.ini) file in the users home directory.
-    See https://github.com/exoscale/cs for more information.
+      See https://github.com/exoscale/cs for more information.
   - This module supports check mode.
 '''