15 files changed, 29 insertions, 19 deletions
diff --git a/doc/source/command-objects/aggregate.rst b/doc/source/command-objects/aggregate.rst
index 6497f632..2a40d234 100644
--- a/doc/source/command-objects/aggregate.rst
+++ b/doc/source/command-objects/aggregate.rst
@@ -139,7 +139,7 @@ Set aggregate properties
 aggregate show
 --------------
 
-Show a specific aggregate
+Display aggregate details
 
 .. program aggregate show
 .. code:: bash
@@ -149,4 +149,4 @@ Show a specific aggregate
 
 .. describe:: <aggregate>
 
-    Aggregate to show (name or ID)
+    Aggregate to display (name or ID)
diff --git a/doc/source/command-objects/catalog.rst b/doc/source/command-objects/catalog.rst
index 99746dd7..4e67f3a4 100644
--- a/doc/source/command-objects/catalog.rst
+++ b/doc/source/command-objects/catalog.rst
@@ -7,6 +7,8 @@ Identity v2
 catalog list
 ------------
 
+List services in the service catalog
+
 .. code:: bash
 
     os catalog list
@@ -14,6 +16,8 @@ catalog list
 catalog show
 ------------
 
+Display service catalog details
+
 .. code:: bash
 
     os catalog show
diff --git a/doc/source/command-objects/consumer.rst b/doc/source/command-objects/consumer.rst
index 59ace845..91294fa2 100644
--- a/doc/source/command-objects/consumer.rst
+++ b/doc/source/command-objects/consumer.rst
@@ -24,7 +24,7 @@ Create new consumer
 consumer delete
 ---------------
 
-Delete a consumer
+Delete consumer
 
 .. program:: consumer delete
 .. code:: bash
diff --git a/doc/source/command-objects/container.rst b/doc/source/command-objects/container.rst
index 3afaeb92..845933d4 100644
--- a/doc/source/command-objects/container.rst
+++ b/doc/source/command-objects/container.rst
@@ -92,7 +92,7 @@ Save container contents locally
 container show
 --------------
 
-Show container details
+Display container details
 
 .. program:: container show
 .. code:: bash
diff --git a/doc/source/command-objects/domain.rst b/doc/source/command-objects/domain.rst
index 66697ac3..94473570 100644
--- a/doc/source/command-objects/domain.rst
+++ b/doc/source/command-objects/domain.rst
@@ -102,7 +102,7 @@ Set domain properties
 domain show
 -----------
 
-Show domain details
+Display domain details
 
 .. program:: domain show
 .. code:: bash
diff --git a/doc/source/command-objects/federation-protocol.rst b/doc/source/command-objects/federation-protocol.rst
index 0ed0980a..5b4ea48a 100644
--- a/doc/source/command-objects/federation-protocol.rst
+++ b/doc/source/command-objects/federation-protocol.rst
@@ -34,7 +34,7 @@ Create new federation protocol
 federation protocol delete
 --------------------------
 
-Delete a federation protocol
+Delete federation protocol
 
 .. program:: federation protocol delete
 .. code:: bash
diff --git a/doc/source/command-objects/flavor.rst b/doc/source/command-objects/flavor.rst
index 31b8e902..0083da0d 100644
--- a/doc/source/command-objects/flavor.rst
+++ b/doc/source/command-objects/flavor.rst
@@ -67,7 +67,7 @@ Create new flavor
 flavor delete
 -------------
 
-Delete a flavor
+Delete flavor
 
 .. program:: flavor delete
 .. code:: bash
diff --git a/doc/source/command-objects/identity-provider.rst b/doc/source/command-objects/identity-provider.rst
index f08cde01..47e274dd 100644
--- a/doc/source/command-objects/identity-provider.rst
+++ b/doc/source/command-objects/identity-provider.rst
@@ -38,7 +38,7 @@ Create new identity provider
 identity provider delete
 ------------------------
 
-Delete an identity provider
+Delete identity provider
 
 .. program:: identity provider delete
 .. code:: bash
diff --git a/doc/source/command-objects/keypair.rst b/doc/source/command-objects/keypair.rst
index 89d12a30..04c5721f 100644
--- a/doc/source/command-objects/keypair.rst
+++ b/doc/source/command-objects/keypair.rst
@@ -30,7 +30,7 @@ Create new public key
 keypair delete
 --------------
 
-Delete a public key
+Delete public key
 
 .. program keypair delete
 .. code:: bash
@@ -55,7 +55,7 @@ List public key fingerprints
 keypair show
 ------------
 
-Show public key details
+Display public key details
 
 .. program keypair show
 .. code:: bash
@@ -70,4 +70,4 @@ Show public key details
 
 .. describe:: <key>
 
-    Public key to show
+    Public key to display
diff --git a/doc/source/command-objects/mapping.rst b/doc/source/command-objects/mapping.rst
index 5c7535bd..25af4740 100644
--- a/doc/source/command-objects/mapping.rst
+++ b/doc/source/command-objects/mapping.rst
@@ -30,7 +30,7 @@ Create new mapping
 mapping delete
 --------------
 
-Delete a mapping
+Delete mapping
 
 .. program:: mapping delete
 .. code:: bash
diff --git a/doc/source/command-objects/object.rst b/doc/source/command-objects/object.rst
index 5cbc95d7..c45c1051 100644
--- a/doc/source/command-objects/object.rst
+++ b/doc/source/command-objects/object.rst
@@ -122,7 +122,7 @@ Save object locally
 object show
 -----------
 
-Show object details
+Display object details
 
 .. program:: object show
 .. code:: bash
diff --git a/doc/source/command-objects/project.rst b/doc/source/command-objects/project.rst
index 6b55b424..b39edb4d 100644
--- a/doc/source/command-objects/project.rst
+++ b/doc/source/command-objects/project.rst
@@ -149,6 +149,8 @@ Set project properties
 project show
 ------------
 
+Display project details
+
 .. program:: project show
 .. code:: bash
 
@@ -165,4 +167,4 @@ project show
 .. _project_show-project:
 .. describe:: <project>
 
-    Project to show (name or ID)
+    Project to display (name or ID)
diff --git a/doc/source/command-objects/region.rst b/doc/source/command-objects/region.rst
index d1aedb31..cb4a059e 100644
--- a/doc/source/command-objects/region.rst
+++ b/doc/source/command-objects/region.rst
@@ -95,7 +95,7 @@ Set region properties
 .. _region_set-region-id:
 .. describe:: <region-id>
 
-    Region ID to modify
+    Region to modify
 
 region show
 -----------
@@ -111,4 +111,4 @@ Display region details
 .. _region_show-region-id:
 .. describe:: <region-id>
 
-    Region ID to display
+    Region to display
diff --git a/doc/source/command-objects/role.rst b/doc/source/command-objects/role.rst
index 19195eb5..57161b06 100644
--- a/doc/source/command-objects/role.rst
+++ b/doc/source/command-objects/role.rst
@@ -142,7 +142,7 @@ Remove role from domain/project : user/group
 
 .. describe:: <role>
 
-    Role to remove from `<project>`:`<user>` (name or ID)
+    Role to remove (name or ID)
 
 role set
 --------
@@ -169,6 +169,8 @@ Set role properties
 role show
 ---------
 
+Display role details
+
 .. program:: role show
 .. code:: bash
 
@@ -177,4 +179,4 @@ role show
 
 .. describe:: <role>
 
-    Role to show (name or ID)
+    Role to display (name or ID)
diff --git a/doc/source/command-objects/user.rst b/doc/source/command-objects/user.rst
index a9a98fe1..9c81a403 100644
--- a/doc/source/command-objects/user.rst
+++ b/doc/source/command-objects/user.rst
@@ -191,6 +191,8 @@ Set user properties
 user show
 ---------
 
+Display user details
+
 .. program:: user show
 .. code:: bash
 
@@ -207,4 +209,4 @@ user show
 .. _user_show-user:
 .. describe:: <user>
 
-    User to show (name or ID)
+    User to display (name or ID)