PEP 8002: Astropy: Improve wording (thanks to Thomas Robitaille)

This commit is contained in:
Antoine Pitrou 2018-09-20 20:28:52 +02:00
parent b67743962b
commit 290fea99b5
1 changed files with 11 additions and 11 deletions

View File

@ -681,22 +681,22 @@ Regular decision process
Code-level decisions Code-level decisions
~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~
The Astropy Project is organized as *sub-packages*. Each sub-package has an The Astropy Project includes the *core Astropy package* and other
official *maintainer* as well as one or more *deputies*, who are responsible *affiliated packages*. For the sake of simplicity, we will avoid
for ensuring code is reviewed and generally architecting the subpackage. discussing affiliated packages, which can have their own rules.
Code-level decisions are therefore made in GitHub issues or pull requests Therefore, everything below will concern the core Astropy package.
(PRs), usually on the basis of consensus, moderated by the maintainer
and deputies of that sub-package. The core Astropy package is organized as *sub-packages*. Each sub-package
has an official *maintainer* as well as one or more *deputies*, who are
responsible for ensuring code is reviewed and generally architecting the
subpackage. Code-level decisions are therefore made in GitHub issues or
pull requests (PRs), usually on the basis of consensus, moderated by the
maintainer and deputies of that sub-package.
When there is specific disagreement, majority vote of those who are involved When there is specific disagreement, majority vote of those who are involved
in the discussion (e.g. PR) determines the winner, with the CoCo called on in the discussion (e.g. PR) determines the winner, with the CoCo called on
to break ties or mediate disagreements. to break ties or mediate disagreements.
.. note::
Some sub-packages (also named "affiliated packages") have a more
independent relationship to the Astropy Project than which is described
here. For simplicity, we decided to omit them from this review.
Non-code decisions Non-code decisions
~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~