realpython#887

kennethreitz · kennethreitz · commit 57b28f8b0836 · 2018-03-07T08:07:41.000-05:00
diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst
@@ -63,21 +63,19 @@ line at the bottom of your :file:`~/.profile` file
 
 .. code-block:: console
 
-    export PATH=/usr/local/bin:/usr/local/sbin:$PATH
+    export PATH="/usr/local/bin:/usr/local/sbin:$PATH"
 
 Now, we can install Python 2.7:
 
 .. code-block:: console
 
     $ brew install python@2
 
-or Python 3:
+Because ``python@2`` is a "keg", we need to update our ``PATH`` again, to point at our new installation:
 
 .. code-block:: console
 
-    $ brew install python
-
-This will take a minute or two.
+    export PATH="/usr/local/opt/python@2/libexec/bin:$PATH"
 
 Homebrew names the executable ``python2`` so that you can still run the system Python via the executable ``python``.
 
