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 efba185389..9dc9a6b83f 100644
--- a/doc/config-reference/block-storage/drivers/vmware-vmdk-driver.xml
+++ b/doc/config-reference/block-storage/drivers/vmware-vmdk-driver.xml
@@ -136,42 +136,42 @@
             drivers:</para>
         <itemizedlist>
             <listitem>
-                <para>create volume</para>
+                <para>Create volume</para>
             </listitem>
             <listitem>
-                <para>create volume from another source volume (Supported only if source volume is
+                <para>Create volume from another source volume. (Supported only if source volume is
                     not attached to an instance.)</para>
             </listitem>
             <listitem>
-                <para>create volume from snapshot</para>
+                <para>Create volume from snapshot</para>
             </listitem>
             <listitem>
-                <para>create volume from glance image</para>
+                <para>Create volume from glance image</para>
             </listitem>
             <listitem>
-                <para>attach volume (When a volume is attached to an instance, a reconfigure
+                <para>Attach volume (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>
             </listitem>
             <listitem>
-                <para>detach volume</para>
+                <para>Detach volume</para>
             </listitem>
             <listitem>
-                <para>create snapshot (Allowed only if volume is not attached to an
+                <para>Create snapshot (Allowed only if volume is not attached to an
                     instance.)</para>
             </listitem>
             <listitem>
-                <para>delete snapshot (Allowed only if volume is not attached to an
+                <para>Delete snapshot (Allowed only if volume is not attached to an
                     instance.)</para>
             </listitem>
             <listitem>
-                <para>upload as image to glance (Allowed only if volume is not attached to an
+                <para>Upload as image to glance (Allowed only if volume is not attached to an
                     instance.)</para>
             </listitem>
         </itemizedlist>
-        <para>Note: Although the VMware ESX VMDK driver supports these operations, it has not been
-            extensively tested.</para>
+        <note><para>Although the VMware ESX VMDK driver supports these operations, it has not been
+            extensively tested.</para></note>
     </simplesect>
     <simplesect>
         <title>Datastore selection</title>