diff --git a/doc/config-reference/block-storage/drivers/vmware-vmdk-driver.xml b/doc/config-reference/block-storage/drivers/vmware-vmdk-driver.xml
index 0695c4e0b7..5eb7bdd082 100644
--- a/doc/config-reference/block-storage/drivers/vmware-vmdk-driver.xml
+++ b/doc/config-reference/block-storage/drivers/vmware-vmdk-driver.xml
@@ -233,15 +233,20 @@
             operations:</para>
         <itemizedlist>
           <listitem>
-            <para>Create, delete, attach, and detach volumes. (When a
-            volume is attached to an instance, a reconfigure operation
-            is performed on the instance to add the volume's VMDK to
-            it. The user must manually rescan and mount the device
-            from within the guest operating system.)</para>
+            <para>Create, delete, attach, and detach volumes.</para>
+            <note>
+              <para>When a volume is attached to an instance, a reconfigure
+                operation is performed on the instance to add the volume's
+                VMDK to it. The user must manually rescan and mount the device
+                from within the guest operating system.</para>
+            </note>
           </listitem>
           <listitem>
-            <para>Create, list, and delete volume snapshots. (Allowed only
-            if volume is not attached to an instance.)</para>
+            <para>Create, list, and delete volume snapshots.</para>
+            <note>
+              <para>Allowed only if volume is not attached to an
+                instance.</para>
+            </note>
           </listitem>
           <listitem>
             <para>Create a volume from a snapshot.</para>
@@ -260,22 +265,31 @@
             </note>
           </listitem>
           <listitem>
-            <para>Copy a volume to an image. (Allowed only if volume is not
-            attached to an instance.)</para>
+            <para>Copy a volume to an image.</para>
+            <note>
+              <para>Allowed only if the volume is not attached to an
+                instance.</para>
+            </note>
           </listitem>
           <listitem>
-            <para>Clone a volume. (Supported only if source volume is not
-            attached to an instance.)</para>
+            <para>Clone a volume.</para>
+            <note>
+              <para>Supported only if the source volume is not attached to an
+                instance.</para>
+            </note>
           </listitem>
           <listitem>
             <para>Backup a volume.</para>
           </listitem>
           <listitem>
-            <para>Restore backup to new or existing volume. (Supported only
-            if the existing volume doesn't contain snapshots.)</para>
+            <para>Restore backup to new or existing volume.</para>
+            <note>
+                <para>Supported only if the existing volume doesn't contain
+                  snapshots.</para>
+            </note>
           </listitem>
           <listitem>
-            <para>Change the volume type of a volume.</para>
+            <para>Change the type of a volume.</para>
             <note>
                 <para>This operation is supported only if the volume state is
                     <literal>available</literal>.