diff --git a/api-ref/src/docbkx/ch_compute-v2.1.xml b/api-ref/src/docbkx/ch_compute-v2.1.xml
index 3e8c95ef5..ed092d187 100644
--- a/api-ref/src/docbkx/ch_compute-v2.1.xml
+++ b/api-ref/src/docbkx/ch_compute-v2.1.xml
@@ -450,17 +450,17 @@
Lists, shows details for, and deletes images. Also sets, lists,
shows details for, and deletes image metadata.
-
-
+
+
An image is a collection of files that you use to create and
rebuild a server. By default, operators provide pre-built
operating system images. You can also create custom images. See
Compute server actions.
-
-
- If you set the image size policy in the policy.json
- file, the OS-EXT-IMG-SIZE:size
extended attribute is
- visible.
+
+
+ By default, the policy.json
file authorizes all users to
+ view the image size in the OS-EXT-IMG-SIZE:size
extended
+ attribute.