diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst
index 3af4295..82b563d 100644
--- a/docs/starting/install/osx.rst
+++ b/docs/starting/install/osx.rst
@@ -35,9 +35,11 @@ simply run
 
     $ ruby -e "$(curl -fsSL https://raw.github.com/mxcl/homebrew/go)"
 
-Then, insert the Homebrew directory at the top of your ``PATH`` environment
-variable. You can do this by adding the following line at the bottom of your
-``~/.bashrc`` file
+The script will expalin what changes it will make and prompt you before the
+installation begins.
+Once you've installed Homebrew, insert the Homebrew directory at the top
+of your ``PATH`` environment variable. You can do this by adding the following
+line at the bottom of your ``~/.bashrc`` file
 
 .. code-block:: console