diff --git a/roles/build-python-release/README.rst b/roles/build-python-release/README.rst
index 452e197a8..e67681d37 100644
--- a/roles/build-python-release/README.rst
+++ b/roles/build-python-release/README.rst
@@ -1,6 +1,6 @@
 Build sdist and wheel for Python projects.
 
-** Role Variables **
+**Role Variables**
 
 .. zuul:rolevar:: release_python
    :default: python
diff --git a/roles/buildset-artifacts-location/README.rst b/roles/buildset-artifacts-location/README.rst
index b39dbd7bd..080713a01 100644
--- a/roles/buildset-artifacts-location/README.rst
+++ b/roles/buildset-artifacts-location/README.rst
@@ -4,11 +4,13 @@ When a 'buildset' directory exists in the job logs, then use
 zuul_return to set buildset_artifacts_url for children jobs.
 
 rpm-build job:
+
 * Create a repository
 * Fetch the repository to "{{ zuul.executor.log_root }}/buildset"
 * Use the buildset-artifacts-location role
 
 rpm-test jobs:
+
 * Install "{{ buildset_artficats_url }}" yum repository
 * Run integration tests
 
diff --git a/roles/stage-output/README.rst b/roles/stage-output/README.rst
index 3dd8d37bc..9da1b4d09 100644
--- a/roles/stage-output/README.rst
+++ b/roles/stage-output/README.rst
@@ -40,7 +40,7 @@ intended to be used before output fetching in a base job's post-playbook.
    `zuul_copy_output` and it won't be applied to files contained in
    folders listed in `zuul_copy_output`.
 
-   Example:
+   Example::
 
      extensions_to_txt:
        conf: True