Made "install dependencies" as Step number one. (python#37)

Mariatta · ncoghlan · commit 93a353174561 · 2016-09-21T15:27:09.000+10:00
diff --git a/index.rst b/index.rst
@@ -14,36 +14,53 @@ Quick Start
 Here are the basic steps needed to get :ref:`set up <setup>` and contribute a
 patch:
 
-1. :ref:`Get the source code <checkout>`::
+1. Set up and install dependencies.
+
+   Install :ref:`Mercurial <vcsetup>` and other dependencies.
+
+   The dependencies needed will depend on the platform you're on.
+   Go to :ref:`Get Setup <setup>` page for detailed information.
+
+2. :ref:`Get the source code <checkout>`::
 
       hg clone https://hg.python.org/cpython
 
-   See :ref:`version control setup <vcsetup>` for installing Mercurial.
 
-2. :ref:`Build Python <compiling>`.  On all platforms, install build
-   dependencies (such as compilers). On :ref:`UNIX <unix-compiling>`
-   (including Mac OS X)::
+3. Build Python.
+
+   Detailed information can be found :ref:`here <compiling>`.
+   There are different instructions for :ref:`UNIX <unix-compiling>`,
+   :ref:`Mac OS <MacOS>`, and :ref:`Windows <windows-compiling>`.
+
+   The command to compile on UNIX is::
+
+      ./configure
+      make -j2
+
+   On some Mac OS:::
 
-      ./configure --with-pydebug && make -j2
+      CPPFLAGS="-I$(brew --prefix openssl)/include" \
+      LDFLAGS="-L$(brew --prefix openssl)/lib" \
+      ./configure --with-pydebug
 
-   On :ref:`Windows <windows-compiling>`::
+   On Windows:::
 
       PCbuild\build.bat -e -d
 
    If the build outputs warnings or errors, :ref:`build-dependencies` provides
    detail on standard library extensions that depend on installing third-party
    libraries for some operating systems.
 
-3. :doc:`Run the tests <runtests>`::
+4. :doc:`Run the tests <runtests>`::
 
-   ./python -m test -j3
+      ./python -m test -j3
 
    On :ref:`most <mac-python.exe>` Mac OS X systems, replace :file:`./python`
    with :file:`./python.exe`.  On Windows, use :file:`python.bat` or
    check the :ref:`Windows instructions <win-python.exe>`.  With Python 2.7,
    replace ``test`` with ``test.regrtest``.
-4. Make the :doc:`patch <patch>`.
-5. Submit it to the `issue tracker`_.
+5. Make the :doc:`patch <patch>`.
+6. Submit it to the `issue tracker`_.
 
 
 Quick Links
diff --git a/setup.rst b/setup.rst
@@ -126,6 +126,8 @@ dependencies for the Python version that you're working on e.g.::
 If that package is not available for your system, try reducing the minor
 version until you find a package that is available.
 
+.. _MacOS:
+
 On **Mac OS X systems**, use the C compiler and other
 development utilities provided by Apple's Xcode Developer Tools.
 The Developer Tools are not shipped with OS X.
