Improve documentation for generating PEP pages. (#1015)

Author: Mariatta

docs/source/pep_generation.rst

@@ -11,11 +11,18 @@ We are generating the PEP pages by lightly parsing the HTML output from the
 
 The PEP Page Generation process is as follows:
 
-1. Set ``PEP_REPO_PATH`` in ``pydotorg/settings/local.py`` to the location
-   of the `PEP Repository`_.
-2. Run ``pep2html.py``
-3. Run ``genpepindex.py``
-4. After all PEP pages are generated into HTML, run::
+1. Clone the PEP Repository, if you have not already done so::
+
+      $ git clone https://github.com/python/peps.git
+
+2. From the cloned PEP Repository, run::
+
+      $ make -j
+
+3. Set ``PEP_REPO_PATH`` in ``pydotorg/settings/local.py`` to the location
+   of the cloned PEP Repository
+
+4. Run in your ``pythondotorg`` repository::
 
    $ ./manage.py generate_pep_pages
 
@@ -45,4 +52,4 @@ dump_pep_pages
 This simply dumps our PEP related pages as JSON. The ``dumpdata`` content is
 written to ``stdout`` just like a normal ``dumpdata`` command.
 
-.. _PEP Repository: https://hg.python.org/peps/
+.. _PEP Repository: https://github.com/python/peps.git