diff --git a/doc/training-guides/module001-ch005-vm-provisioning-walk-through.xml b/doc/training-guides/module001-ch005-vm-provisioning-walk-through.xml
index 243af509..22d327b0 100644
--- a/doc/training-guides/module001-ch005-vm-provisioning-walk-through.xml
+++ b/doc/training-guides/module001-ch005-vm-provisioning-walk-through.xml
@@ -182,12 +182,11 @@
Launching an instanceTo launch an instance, the user selects an image, a flavor,
and other optional attributes. In this case the selected
- flavor provides a root volume (as all flavors do) labeled vda in
- the diagram and additional ephemeral storage labeled vdb in the
- diagram. The user has also opted to map a volume from the
+ flavor provides a root volume (as all flavors do). Let us assume that the
+ root volume is labelled as 'vda' and additional ephemeral storage labelled
+ as 'vdb'. The user has also opted to map a volume from the
cinder-volume
- store to the third virtual disk, vdc, on this
- instance.
+ store to the third virtual disk, vdc, on this instance.
Figure 2.2. Instance creation from image and run time
state
@@ -207,11 +206,10 @@
is an empty disk with an emphemeral life as it is destroyed when
you delete the instance. The compute node attaches to the
requested cinder-volume
- using iSCSI and maps this to the third
- disk (vdc) as requested. The vCPU and memory resources are
- provisioned and the instance is booted from the first drive. The
- instance runs and changes data on the disks indicated in red in
- the diagram.
+ using iSCSI and maps this to the third disk (vdc) as requested.
+ The vCPU and memory resources are provisioned and the instance is booted
+ from the first drive. The instance runs and changes data on the disks
+ indicated in red in the diagram.
There are many possible variations in the details of the
scenario, particularly in terms of what the backing storage is
and the network protocols used to attach and move storage. One
@@ -237,7 +235,7 @@
Once you launch a VM in OpenStack, there's something more
going on in the background. To understand what's happening
- behind the dashboard, lets take a deeper dive into OpenStack’s
+ behind the dashboard, lets take a deeper dive into OpenStack's
VM provisioning. For launching a VM, you can either use
the command-line interfaces or the OpenStack dashboard.