diff --git a/xos/configurations/cord/README.md b/xos/configurations/cord/README.md
index 4905475..862eae9 100644
--- a/xos/configurations/cord/README.md
+++ b/xos/configurations/cord/README.md
@@ -24,9 +24,9 @@
 1. *Slice mysite_volt*: for running OvS with the `olt` app as controller
 1. *Slice mysite_clients*: a subscriber client for end-to-end testing
 
-After the first VM is created (for running the virtualbng app) it is necessary to configure XOS's *service_vbng* with its URL.
+After the first VM is created (for running the `virtualbng` app) it is necessary to configure XOS's *service_vbng* with its URL.
 Log into XOS, click on *Services* tab at left, then *service_vbng* icon.  Change **Vbng url:** to point to the IP address on
-`flat-lan-1-net` of the VM (will start with 10.11).
+`flat-lan-1-net` of the VM (it will start with 10.11).
 
 Once all the VMs are up and the ONOS apps are configured, XOS should be able to get an address mapping from the `virtualbng`
 ONOS app when creating a vCPE.  To test this:
@@ -36,4 +36,4 @@
 * `$ make -f Makefile.inside setup_subscriber`
 
 After a bit, a new VM should be created in slice *mysite_vcpe* running the vCPE Docker container.  To verify that it has
-received an IP address mapping, look at the **Routeable subnet** field in the appropriate *Vbng tenant* object in XOS.  It should contain an IP address in the 10.254.0.0/24 subnet.
+received an IP address mapping, look at the **Routeable subnet:** field in the appropriate *Vbng tenant* object in XOS.  It should contain an IP address in the 10.254.0.0/24 subnet.