2 files changed, 96 insertions, 1 deletions
diff --git a/doc/source/command-objects/policy.rst b/doc/source/command-objects/policy.rst
new file mode 100644
index 00000000..195a89f2
--- /dev/null
+++ b/doc/source/command-objects/policy.rst
@@ -0,0 +1,95 @@
+======
+policy
+======
+
+Identity v3
+
+policy create
+-------------
+
+Create new policy
+
+.. program:: policy create
+.. code:: bash
+
+    os policy create
+        [--type <type>]
+        <filename>
+
+.. option:: --type <type>
+
+    New MIME type of the policy rules file (defaults to application/json)
+
+.. describe:: <filename>
+
+    New serialized policy rules file
+
+policy delete
+-------------
+
+Delete policy
+
+.. program:: policy delete
+.. code:: bash
+
+    os policy delete
+        <policy>
+
+.. describe:: <policy>
+
+    Policy to delete
+
+policy list
+-----------
+
+List policies
+
+.. program:: policy list
+.. code:: bash
+
+    os policy list
+        [--long]
+
+.. option:: --long
+
+    List additional fields in output
+
+policy set
+----------
+
+Set policy properties
+
+.. program:: policy set
+.. code:: bash
+
+    os policy set
+        [--type <type>]
+        [--rules <filename>]
+        <policy>
+
+.. option:: --type <type>
+
+    New MIME type of the policy rules file
+
+.. describe:: --rules <filename>
+
+    New serialized policy rules file
+
+.. describe:: <policy>
+
+    Policy to modify
+
+policy show
+-----------
+
+Display policy details
+
+.. program:: policy show
+.. code:: bash
+
+    os policy show
+        <policy>
+
+.. describe:: <policy>
+
+    Policy to display
diff --git a/doc/source/commands.rst b/doc/source/commands.rst
index 6fe91a1f..6dbaf117 100644
--- a/doc/source/commands.rst
+++ b/doc/source/commands.rst
@@ -98,7 +98,7 @@ referring to both Compute and Volume quotas.
 * ``module``: internal - installed Python modules in the OSC process
 * ``network``: Network - a virtual network for connecting servers and other resources
 * ``object``: (**Object Store**) a single file in the Object Store
-* ``policy``: Identity - determines authorization
+* ``policy``: (**Identity**) determines authorization
 * ``project``: (**Identity**) owns a group of resources
 * ``quota``: (**Compute**, **Volume**) resource usage restrictions
 * ``region``: (**Identity**) a subset of an OpenStack deployment