diff --git a/docs/starting/install/osx.rst b/docs/starting/install/osx.rst
index 1e5e694..8aa75cf 100644
--- a/docs/starting/install/osx.rst
+++ b/docs/starting/install/osx.rst
@@ -3,13 +3,21 @@ Installing Python on Mac OS X
*Or, "Installing Python 2.7 via Homebrew".*
+The latest version of Mac OS X, **comes with Python 2.7 out of the box**.
+
+You do not need to install or configure anything else to use Python. Having said that, I would strongly recommend that you install the tools and libraries described in the next section before you start building Python applications for real-world use. In particular, you should always install Distribute, as it makes it much easier for you to use other third-party Python libraries.
+
+The version of Python that ships with OS X is great for learning, but it's not good for development. It's slightly out of date, and Apple has made significant changes that can cause hidden bugs.
+
Package Manager
---------------
-While Lions comes with a large number of UNIX utilities, those
+While Lion comes with a large number of UNIX utilities, those
familiar with Linux systems will notice one key component missing: a decent
package manager. `Homebrew `_ fills this void.
+First, you'll need to have GCC installed to compile Python. You can either get this from `XCode `_ or the smaller `OSX-GCC-Installer `_ package.
+
To `install Homebrew `_, simply run::
$ ruby -e "$(curl -fsS https://raw.github.com/gist/323731)"