diff --git a/docs/deployment.rst b/docs/deployment.rst
index b08d4ffec..1333b65c0 100644
--- a/docs/deployment.rst
+++ b/docs/deployment.rst
@@ -94,17 +94,16 @@ of a stunnel configuration file:
 
 Serving the UI build from the distribution directory
 ----------------------------------------------------
-To serve the UI from the ``treeherder-ui/dist`` directory, from the ``treeherder-ui`` directory run:
+To serve the UI from the ``treeherder-ui/dist`` directory, in the ``treeherder-ui`` directory run:
 
 .. code-block:: bash
 
   (venv)vagrant@precise32:~/treeherder-ui$ grunt build
 
-This will build the UI by concatenating and minifying the js and css and move all required assets to a directory called ``dist`` in the repository root of ``treeherder-ui``:
-In ``treeherder-service/Vagrantfile`` uncomment this line
+This will build the UI by concatenating and minifying the js and css and move all required assets to a directory called ``dist`` in the repository root of ``treeherder-ui``. In ``treeherder-service/Vagrantfile`` uncomment this line:
 
 .. code-block:: ruby
 
   puppet.manifest_file = "production.pp"
 
-this puppet manifest sets the web application directory to the ``dist`` directory.
+The ``production.pp`` manifest sets the web application directory to the ``dist`` directory.