PEP 772: Follow up PR to clarify a few more things

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 <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 <appendix_C>`.
 
 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 <process>` 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