diff --git a/doc/source/admin/policy-json-file.rst b/doc/source/admin/policy-json-file.rst
index b5356a80..8d918d8a 100644
--- a/doc/source/admin/policy-json-file.rst
+++ b/doc/source/admin/policy-json-file.rst
@@ -194,10 +194,10 @@ Rules can be:
 
 Special checks are:
 
--  ``<role>:<role name>``, a test whether the API credentials contain
+-  ``role:<role name>``, a test whether the API credentials contain
    this role.
 
--  ``<rule>:<rule name>``, the definition of an alias.
+-  ``rule:<rule name>``, the definition of an alias.
 
 -  ``http:<target URL>``, which delegates the check to a remote server.
    The API is authorized when the server returns True.
diff --git a/doc/source/admin/policy-yaml-file.rst b/doc/source/admin/policy-yaml-file.rst
index 057f4931..0018f8ad 100644
--- a/doc/source/admin/policy-yaml-file.rst
+++ b/doc/source/admin/policy-yaml-file.rst
@@ -186,10 +186,10 @@ Rules can be:
 
 Special checks are:
 
--  ``<role>:<role name>``, a test whether the API credentials contain
+-  ``role:<role name>``, a test whether the API credentials contain
    this role.
 
--  ``<rule>:<rule name>``, the definition of an alias.
+-  ``rule:<rule name>``, the definition of an alias.
 
 -  ``http:<target URL>``, which delegates the check to a remote server.
    The API is authorized when the server returns True.