From c62631806ecfc550e64be7d88cf1190702d3634b Mon Sep 17 00:00:00 2001 From: Barry Warsaw Date: Mon, 21 Apr 2025 17:07:13 -0700 Subject: [PATCH 1/2] Follow up PR for PEP 772 outstanding threads * Be explicit that the Packaging Council gains its authority through delegation from the Steering Council. * Clarify that voting members can nominate anybody for PC elections, and that nominees do not need to be voting members themselves. * Add a placeholder appendix for listing the initial set of community voting members. * Add some cross references for clarity --- peps/pep-0772.rst | 36 ++++++++++++++++++++++++++---------- 1 file changed, 26 insertions(+), 10 deletions(-) diff --git a/peps/pep-0772.rst b/peps/pep-0772.rst index df4fadbcca9..24bcd43a4d4 100644 --- a/peps/pep-0772.rst +++ b/peps/pep-0772.rst @@ -168,10 +168,11 @@ publicly in a timely fashion. Delegations ----------- -The Python Steering Council will delegate decision making to the Packaging -Council for PEPs related to the Python packaging. The bodies would work -together on issues that intersect the packaging domain and language stewardship -(including the CPython implementation, standard library, and distribution). +The Packaging Council gains its authority over packaging matters via delegation from the Python +Steering Council. Upon acceptance of this PEP, the Steering Council will formally issue a standing +delegation to the Packaging Council for PEPs related to Python packaging. The bodies would work +together on issues that intersect the packaging domain and language stewardship (including the +CPython implementation, standard library, and distribution). The PSF Board is encouraged to formally deactivate the Packaging Workgroup and the Packaging Council would take on the responsibilities of the PSF's Packaging @@ -188,9 +189,9 @@ Election of the council A council election consists of two phases: -* Phase 1: A voting member (defined later in this document) can self-nominate - themselves, or nominate any other candidate, for the council elections. Such a nomination must include - information about the member's relevant affiliations. +* Phase 1: A voting member (defined later in this document) can nominate any individual for the + council elections, including themselves. Nominations must include information about the nominee's + relevant affiliations. Nominees for the Packaging Council do not need to be voting members. * Phase 2: Each voting member can assign zero to five stars to each candidate. Voting is performed anonymously. The outcome of the vote is determined using the `STAR voting system`_, modified to use the `Multi-winner Bloc STAR`_ @@ -276,6 +277,7 @@ Responsibility Voting members participate in formal votes to elect the Packaging Council. +.. _process: Processes ========= @@ -295,7 +297,7 @@ formalise their participation in the packaging community. This includes: * Wider community members: An initial set of for-profit companies, nonprofit organizations, academic or educational institutions and smaller unaffiliated projects would be invited to nominate three individuals to represent them. - See [link to Appendix] for the initial set of community voting members. + See :ref:`the initial set of community voting members `. Adding a new member ------------------- @@ -415,8 +417,10 @@ As noted in the abstract, the focus of this PEP is on providing a minimal-but-solid foundation for further governance decisions. The specifics of this relationship would be figured out by the inaugural council. +.. _appendix_a: + ======================================= -Appendix: Approval process for this PEP +Appendix A: Approval process for this PEP ======================================= This PEP would likely require an atypical process for approval given that it @@ -430,8 +434,10 @@ To that end, the process for approval for this PEP will be: * Submit this PEP for the Python Steering Council's comments and approval. * Reconcile any outstanding variances in text and repeat, if necessary. +.. _appendix_b: + ================================================= -Appendix: Operational suggestions for the council +Appendix B: Operational suggestions for the council ================================================= This section is based on what the PEP's authors view as things that would be @@ -459,6 +465,16 @@ Packaging Council will meet on a regular basis (twice a month). * Provide casual real-time opportunities for people to bring topics that are not PEPs, like office hours, a forum channel, or panels at Python events. +.. _appendix_c: + +==================================================== +Appendix C: Initial list of community voting members +==================================================== + +This appendix will list the initial set of community voting members once the :ref:`process of +selecting ` those community members has been completed. + + .. _Python Packaging Authority (PyPA): https://packaging.python.org/en/latest/glossary/#term-Python-Packaging-Authority-PyPA .. _pip: https://packaging.python.org/en/latest/key_projects/#pip .. _virtualenv: https://packaging.python.org/en/latest/key_projects/#virtualenv From cf358159bad5c01e5795a0adf8910deea6b19bd6 Mon Sep 17 00:00:00 2001 From: Barry Warsaw Date: Mon, 21 Apr 2025 17:17:54 -0700 Subject: [PATCH 2/2] Add another cross reference and fix linting --- peps/pep-0772.rst | 14 ++++++++------ 1 file changed, 8 insertions(+), 6 deletions(-) diff --git a/peps/pep-0772.rst b/peps/pep-0772.rst index 24bcd43a4d4..f343b37cc15 100644 --- a/peps/pep-0772.rst +++ b/peps/pep-0772.rst @@ -189,8 +189,8 @@ Election of the council A council election consists of two phases: -* Phase 1: A voting member (defined later in this document) can nominate any individual for the - council elections, including themselves. Nominations must include information about the nominee's +* Phase 1: A :ref:`voting member ` can nominate any individual for the council + elections, including themselves. Nominations must include information about the nominee's relevant affiliations. Nominees for the Packaging Council do not need to be voting members. * Phase 2: Each voting member can assign zero to five stars to each candidate. Voting is performed anonymously. The outcome of the vote is determined using @@ -268,6 +268,8 @@ During a council term, if changing circumstances cause this rule to be broken council members must resign to remedy the issue, and the resulting vacancies can then be filled as normal. +.. _voting-member: + -------------- Voting members -------------- @@ -419,9 +421,9 @@ this relationship would be figured out by the inaugural council. .. _appendix_a: -======================================= +========================================= Appendix A: Approval process for this PEP -======================================= +========================================= This PEP would likely require an atypical process for approval given that it requires changes to PyPA's governance (which involves a PyPA-committers vote) @@ -436,9 +438,9 @@ To that end, the process for approval for this PEP will be: .. _appendix_b: -================================================= +=================================================== Appendix B: Operational suggestions for the council -================================================= +=================================================== This section is based on what the PEP's authors view as things that would be beneficial for the Packaging Council to establish operational processes for.