docs: Incororate Scott's overall review

Change-Id: Ic70a62e17891fa9291a5274400ae89f1d6194b6e
Signed-off-by: John DeNisco <jdenisco@cisco.com>
diff --git a/docs/gettingstarted/users/installing/ubuntu.rst b/docs/gettingstarted/users/installing/ubuntu.rst
index 9c082e6..5b4a1d8 100644
--- a/docs/gettingstarted/users/installing/ubuntu.rst
+++ b/docs/gettingstarted/users/installing/ubuntu.rst
@@ -3,13 +3,13 @@
 .. toctree::
  
 Ubuntu 16.04 - Setup the fd.io Repository
-=========================================
+==========================================
 
-From the following choose one of the releases to install.
+From the following, choose one of the releases to install.
 
 
 Update the OS
--------------
+-----------------------
 
 It is probably a good idea to update and upgrade the OS before starting
 
@@ -19,7 +19,7 @@
 
 
 Point to the Repository
------------------------
+-----------------------------------
 
 Create a file **"/etc/apt/sources.list.d/99fd.io.list"** with the contents that point to
 the version needed. The contents needed are shown below.
@@ -27,7 +27,7 @@
 .. _install_vpp:
 
 VPP latest Release
-^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^
 
 Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents:
 
@@ -37,7 +37,7 @@
 
 
 VPP stable/1804 Branch
-^^^^^^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^^^^
 
 Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents:
 
@@ -47,7 +47,7 @@
 
 
 VPP master Branch
-^^^^^^^^^^^^^^^^^
+^^^^^^^^^^^^^^^^^^^^
 
 Create the file **/etc/apt/sources.list.d/99fd.io.list** with contents:
 
@@ -57,7 +57,7 @@
 
 
 Install the Mandatory Packages
-==============================
+===============================
 
 .. code-block:: console
 
@@ -66,7 +66,7 @@
 
 
 Install the Optional Packages
-=============================
+==============================
 
 .. code-block:: console