On 9/13/2021 8:12 PM, Ethan Furman wrote:
On 9/13/21 9:03 AM, Steve Dower wrote:
> You *are* allowed to put some (brief) details in the abstract. No
need to avoid spoilers ;)
>
> As it stands, "it is time" on its own is a really bad reason to
change anything. So you're
> preemptively making it sound like the PEP has no solid backing.
Abstract
========
Update the ``repr()``, ``str()``, and ``format()`` of the various Enum
types
for consistency and to better match their intended purpose.
Better?
You don't have a one sentence summary of what the changes entail?
"Originally these were based on the idea that ..., but now will work
better for ... by making the results more consistent with ..." (where
each "..." is filled with specific things).
It doesn't have to save me reading the whole thing, but if I'm digging
through documents going "why am I seeing <Red:1> instead of just '1'",
it should confirm that this is the right document to read.
(Alternatively, think about writing the tweet here that you want people
to include when they share your PEP, assuming that 99% of people won't
actually click through to the document. What can you tell them so that
they at least know what is coming?)
Cheers,
Steve
_______________________________________________
Python-Dev mailing list -- python-dev@python.org
To unsubscribe send an email to python-dev-le...@python.org
https://mail.python.org/mailman3/lists/python-dev.python.org/
Message archived at
https://mail.python.org/archives/list/python-dev@python.org/message/VQI5IVW5B6NQB246YYOSAW5DP3G2ZWAQ/
Code of Conduct: http://python.org/psf/codeofconduct/
