PEP 1: Update to reflect best practices in PEP annoucement/discussion#2346
Merged
AA-Turner merged 1 commit intopython:mainfrom Feb 22, 2022
Merged
PEP 1: Update to reflect best practices in PEP annoucement/discussion#2346AA-Turner merged 1 commit intopython:mainfrom
AA-Turner merged 1 commit intopython:mainfrom
Conversation
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This updates PEP 1 (and a few small relevant parts of PEP 12 and the template) to reflect present real-world practice by the SC , as well as the recommendations we agreed on in #2266 , in order to clarify the current process for official discussion, announcement and resolution of PEPs, and improve the experience for PEP authors, the SC/delegates and the community, and avoid confusion, uncertainty and mistakes around these points, and update/remove related out of date content that no longer accurately reflects the de jure or de facto process.
As part of this change, it re-organizes the various scattered, sometimes duplicative or even contradictory paragraphs discussing PEP discussion, announcement and similar into one coherent section, with a clearer, more sequential and logical ordering of the overall process, and adds additional clarifying detail and guidance on points that were previously considered implicit or not referred to at all.
To note, I did not make the changes proposed for the
Post-Historyfield (beyond those intrinsically linked here), leaving that for a separate PR (which shouldn't require SC review, as those changes are purely technical in nature). Additionally, while incidental to updating relevant outdated guidance on this specific topic, I did clarify the time and process to submit a PEP for SC consideration (another major point of confusion for some of the recent PEP author situations that motivated this change), further clarification and updates on that will be handled separately, with appropriate SC review. I also noticed some smaller, unrelated items that were out of date, that will also be addressed separately.Following editorial review by the PEP editors and those involved in that discussion, I'm thinking we'll want to request SC review on their issue tracker before we merge this?
Fixes #2266