El mar, 22 mar 2022 a las 3:40, <encukou@gmail.com> escribió:
Dear typing-sig, Typing-related PEPs are becoming more common, and we'd like to propose some changes to how they are handled.
First, we feel that it is time to convert PEPs (proposals) to specifications. We're getting to the point where we might refer to a feature as “PEP 589 as amended by PEP 655”. To understand a feature, users (and implementers of typing tools) must read through proposal documents that contain motivation, discussion, and sometimes even information that's obsolete today. The use of PEP numbers in everyday communication makes the field even less accessible to outsiders. The Python Packaging Authority (PyPA) used to be in a similar situation, and moved to a model of [specifications], which contain current information, and PEPs as change proposals, which contain a summary of each change and the reasoning (motivation, rationale, discussion summary) for each change. The work of converting existing PEPs to spec documents is not done, but the eventual goal is clear. We ask you to consider adopting a similar model.
[specifications]: https://packaging.python.org/en/latest/specifications/
As Sebastian already said, we have plans to gather such specs at typing.readthedocs.io. We haven't made much progress there, but hopefully we can get to a state where the canonical specs are not just in PEPs.
Second, we'd like to see some kind of typing-sig delegation. For PEPs like 655 (Marking individual TypedDict items as required or potentially-missing), which only affect typing.py and external tools, consensus on typing-sig is by far the most important consideration for accepting or rejecting a PEP. If you could appoint a person (or committee) you trust to speak on behalf of typing-sig -- that is, seek consensus on the list and fairly summarize it -- it would simplify the decision process. It could even be the first step toward delegating typing-related PEPs entirely.
I've also been thinking that a standing delegation for non-syntactic typing PEPs makes sense. If he's willing to do it, Guido would be the obvious candidate for a standing delegation.
Happy typing! – Petr, on behalf of the Steering Council _______________________________________________ Typing-sig mailing list -- typing-sig@python.org To unsubscribe send an email to typing-sig-leave@python.org https://mail.python.org/mailman3/lists/typing-sig.python.org/ Member address: jelle.zijlstra@gmail.com