PEP 1/PEP 12: Update PEP number assignment guidance (#3163)

Co-authored-by: C.A.M. Gerlach <CAM.Gerlach@Gerlach.CAM>

pep-0001.txt

@@ -185,8 +185,11 @@ corrected by the editors).
 The standard PEP workflow is:
 
 * You, the PEP author, fork the `PEP repository`_, and create a file named
-  ``pep-9999.rst`` that contains your new PEP.  Use "9999" as your draft PEP
+  :file:`pep-{NNNN}.rst` that contains your new PEP.  :samp:`{NNNN}` should be the next
-  number.
+  available PEP number not used by a published or in-PR PEP.
+
+* In the "PEP:" header field, enter the PEP number that matches your filename
+  as your draft PEP number.
 
 * In the "Type:" header field, enter "Standards Track",
   "Informational", or "Process" as appropriate, and for the "Status:"
@@ -791,12 +794,11 @@ problem, ask the author(s) to use :pep:`12` as a template and resubmit.
 
 Once the PEP is ready for the repository, a PEP editor will:
 
-* Assign a PEP number (almost always just the next available number,
+* Check that the author has selected a valid PEP number or assign them a
-  but sometimes it's a special/joke number, like 666 or 3141).
+  number if they have not (almost always just the next available number, but
-  (Clarification: For Python 3, numbers in the 3000s were used for
+  sometimes it's a special/joke number, like 666 or 3141).
-  Py3k-specific proposals.  But now that all new features go into
+
-  Python 3 only, the process is back to using numbers in the 100s again.
+  Remember that numbers below 100 are meta-PEPs.
-  Remember that numbers below 100 are meta-PEPs.)
 
 * Check that the author has correctly labeled the PEP's type
   ("Standards Track", "Informational", or "Process"), and marked its

pep-0012.rst

@@ -60,14 +60,10 @@ Once you've decided which type of PEP yours is going to be, follow the
 directions below.
 
 - Make a copy of this file (the ``.rst`` file, **not** the HTML!) and
-  perform the following edits. Name the new file ``pep-9999.rst`` if
+  perform the following edits. Name the new file :file:`pep-{NNNN}.rst`, using
-  you don't yet have a PEP number assignment, or ``pep-NNNN.rst`` if
+  the next available number (not used by a published or in-PR PEP).
-  you do. Those with push permissions are welcome to claim the next
-  available number (ignoring the special blocks 3000 and 8000, and a
-  handful of special allocations - currently 666, 754, and 801) and
-  push it directly.
 
-- Replace the "PEP: 12" header with "PEP: 9999" or "PEP: NNNN",
+- Replace the "PEP: 12" header with "PEP: NNNN",
   matching the file name. Note that the file name should be padded with
   zeros (eg ``pep-0012.rst``), but the header should not (``PEP: 12``).
 
@@ -158,7 +154,7 @@ directions below.
   non-inline link targets referenced by the text.
 
 - Run ``./build.py`` to ensure the PEP is rendered without errors,
-  and check that the output in ``build/pep-9999.html`` looks as you intend.
+  and check that the output in :file:`build/pep-{NNNN}.html` looks as you intend.
 
 - Create a pull request against the `PEPs repository`_.