Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

"PEP numbers never change" verbiage is not in PEP 1 #2087

Closed
AndreasChristianson opened this issue Sep 22, 2021 · 2 comments · Fixed by #2090
Closed

"PEP numbers never change" verbiage is not in PEP 1 #2087

AndreasChristianson opened this issue Sep 22, 2021 · 2 comments · Fixed by #2090

Comments

@AndreasChristianson
Copy link
Contributor

Problem

The introduction to PEP 0 references PEP 1 as a source for

PEP numbers are assigned by the PEP editors, and once assigned are never changed [1].

But PEP 1 doesn't say anything about PEP numbers never changing.

Research

While skimming PEP 1, I found information about the PEP editor assigning a number:

Once the PEP is ready for the repository, a PEP editor will:
Assign a PEP number (almost always just the next available number, but sometimes it's a special/joke number, like 666 or 3141). (Clarification: For Python 3, numbers in the 3000s were used for 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.)

and

The PEP editors are individuals responsible for managing the administrative and editorial aspects of the PEP workflow (e.g. assigning PEP numbers and changing their status). See PEP Editor Responsibilities & Workflow for details.

But I didn't find any reference to that number never changing.

Proposal:

Can we change PEP 0's introduction so that the reference is specific to assigning numbers?

PEP numbers are assigned by the PEP editors[1], and once assigned are never changed.

Link

peps/pep0/constants.py

Lines 22 to 27 in 40ef562

intro = """\
This PEP contains the index of all Python Enhancement Proposals,
known as PEPs. PEP numbers are assigned by the PEP editors, and
once assigned are never changed [1_]. The version control history [2_] of
the PEP texts represent their historical record.
"""

@gvanrossum
Copy link
Member

Sounds good. Can you submit a PR?

AndreasChristianson added a commit to AndreasChristianson/peps that referenced this issue Sep 27, 2021
pep 1 does not indicate that pep numbers will never be changed
(though I agree that not changing them is a good idea)
closes python#2087
@AndreasChristianson
Copy link
Contributor Author

Sounds good. Can you submit a PR?

Done

gvanrossum pushed a commit that referenced this issue Sep 27, 2021
pep 1 does not indicate that pep numbers will never be changed
(though I agree that not changing them is a good idea)
closes #2087
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants