diff --git a/nova/policies/extended_server_attributes.py b/nova/policies/extended_server_attributes.py
index 063534696f41..65c45ba2de4a 100644
--- a/nova/policies/extended_server_attributes.py
+++ b/nova/policies/extended_server_attributes.py
@@ -29,15 +29,16 @@ extended_server_attributes_policies = [
 
 This rule will control the visibility for a set of servers attributes:
 
-- OS-EXT-SRV-ATTR:host
-- OS-EXT-SRV-ATTR:instance_name
-- OS-EXT-SRV-ATTR:reservation_id (since microversion 2.3)
-- OS-EXT-SRV-ATTR:launch_index (since microversion 2.3)
-- OS-EXT-SRV-ATTR:hostname (since microversion 2.3)
-- OS-EXT-SRV-ATTR:kernel_id (since microversion 2.3)
-- OS-EXT-SRV-ATTR:ramdisk_id (since microversion 2.3)
-- OS-EXT-SRV-ATTR:root_device_name (since microversion 2.3)
-- OS-EXT-SRV-ATTR:user_data (since microversion 2.3)""",
+- ``OS-EXT-SRV-ATTR:host``
+- ``OS-EXT-SRV-ATTR:instance_name``
+- ``OS-EXT-SRV-ATTR:reservation_id`` (since microversion 2.3)
+- ``OS-EXT-SRV-ATTR:launch_index`` (since microversion 2.3)
+- ``OS-EXT-SRV-ATTR:hostname`` (since microversion 2.3)
+- ``OS-EXT-SRV-ATTR:kernel_id`` (since microversion 2.3)
+- ``OS-EXT-SRV-ATTR:ramdisk_id`` (since microversion 2.3)
+- ``OS-EXT-SRV-ATTR:root_device_name`` (since microversion 2.3)
+- ``OS-EXT-SRV-ATTR:user_data`` (since microversion 2.3)
+""",
         [
             {
                 'method': 'GET',
diff --git a/nova/policies/extended_status.py b/nova/policies/extended_status.py
index 1ca990d89bbe..89ed7af68d28 100644
--- a/nova/policies/extended_status.py
+++ b/nova/policies/extended_status.py
@@ -29,9 +29,9 @@ extended_status_policies = [
 
 This policy will control the visibility for a set of attributes:
 
-- OS-EXT-STS:task_state
-- OS-EXT-STS:vm_state
-- OS-EXT-STS:power_state
+- ``OS-EXT-STS:task_state``
+- ``OS-EXT-STS:vm_state``
+- ``OS-EXT-STS:power_state``
 """,
         [
             {