diff --git a/peps/pep-0772.rst b/peps/pep-0772.rst index df4fadbcca9..f343b37cc15 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 :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 the `STAR voting system`_, modified to use the `Multi-winner Bloc STAR`_ @@ -267,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 -------------- @@ -276,6 +279,7 @@ Responsibility Voting members participate in formal votes to elect the Packaging Council. +.. _process: Processes ========= @@ -295,7 +299,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,9 +419,11 @@ 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: Approval process for this PEP -======================================= +.. _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) @@ -430,9 +436,11 @@ 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: Operational suggestions for the council -================================================= +.. _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. @@ -459,6 +467,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