Skip to content

Commit d0eacc3

Browse files
committed
Added intro to 'How to teach this'
1 parent 71d14b9 commit d0eacc3

File tree

1 file changed

+22
-11
lines changed

1 file changed

+22
-11
lines changed

peps/pep-0771.rst

Lines changed: 22 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -573,6 +573,26 @@ There are no known security implications for this PEP.
573573
How to teach this
574574
=================
575575

576+
This section outlines information that should be made available to people in
577+
different groups in the community in relation to the implementation of this PEP.
578+
Some aspects described below will be relevant even before the PEP is fully
579+
implemented in packaging tools as there are some preparations that can be done
580+
in advance of this implementation to facilitate any potential transition later
581+
on. The groups covered below are:
582+
583+
- `Package end users`_
584+
- `Package authors`_
585+
- `Packaging repository maintainers`_
586+
587+
Package end users
588+
-----------------
589+
590+
Package users should be provided with clear installation instructions that show
591+
what extras are available for packages and how they behave, for example
592+
explaining that by default some recommended dependencies or a given frontend or
593+
backend will be installed, and how to opt out of this or override defaults,
594+
depending what is available.
595+
576596
Package authors
577597
---------------
578598

@@ -707,17 +727,8 @@ therefore need to carefully consider a migration plan, coordinating with the
707727
authors of ``package2``.
708728

709729

710-
Package users
711-
-------------
712-
713-
Package users should be provided with clear installation instructions that show
714-
what extras are available for packages and how they behave, for example
715-
explaining that by default some recommended dependencies or a given frontend or
716-
backend will be installed, and how to opt out of this or override defaults,
717-
depending what is available.
718-
719-
Repackagers of Python libraries
720-
-------------------------------
730+
Packaging repository maintainers
731+
--------------------------------
721732

722733
The impact on individuals who repackage Python libraries for different
723734
distributions, such as `conda <https://docs.conda.io>`_, `Homebrew

0 commit comments

Comments
 (0)