* PEP 1: Refine phrasing and organization of PEP-delegate description
* PEP 1: Further tweak phrasing of PEP delegate description
* PEP 1: Incorporate further reviewer suggestions on PEP-Delegate section
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
Co-authored-by: Jelle Zijlstra <jelle.zijlstra@gmail.com>
* Update language on PEP-Delegate
* Add review feedback from @JelleZijlstra and @AA-Turner
* Update pep-0001.txt
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* Update pep-0001.txt
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
* Update pep-0001.txt
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Co-authored-by: Barry Warsaw <barry@python.org>
Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Huge thank you to everyone who helped get this across the finish line, especially @gvanrossum! Well done to all of us, @mrkmndz @pradeep90 @vsiles @fylux!
In preparation for the 1.0.0** release of the TUF reference
implementation `python-tuf` documentation referenced in this PEP is
being moved. This patch updates the corresponding links in the PEP.
** See 059bfda391/docs/1.0.0-ANNOUNCEMENT.md
More specifically, the following link changes are performed:
- METADATA.md
to: metadata format section in TUF spec
Note: alternatively this could link to the new location of
METADATA.md (see theupdateframework/python-tuf#1769), but the spec
seems like a better resource
- TUTORIAL.md#repo-management
to: new metadata API doc on readthedocs and new repo
example/tutorial
- TUTORIAL.md#lazy-bin-walk
to: new hashed bin delegation example/tutorial
- client implementation
to: new client doc on readthedocs
Signed-off-by: Lukas Puehringer <lukas.puehringer@nyu.edu>
We're getting ready for a final request for comments to python-dev,
so I did one more pass through the PEP to catch remaining readability
issues (I was especially looking for things easier to see on the actual
PEP page with formatting than the rst doc):
- found an incorrectly formatted hyperlink
- changed some sentences with ambiguous pronouns
- broke up a couple of sentences that seemed too long
- tweaked a few places where the wording was okay but nonstandard
* Add more rejected alternatives
- Rust-style syntax
- Forced outer parentheses
- Improving readability of existing callable type
* Add discussion of alternative | precedence
* Add blank lines for bullet lists
* Fixes based on initial review
* More tweaks from review
* More updates based on review