PEP 622: Proposed rewrite of Abstract and Overview (mostly) by @willingc

[gvanrossum]

I made a few changes to Carol's text, in particular I made the bulleted lists more consistent and switched some commas around. I also removed the ToC that Carol included at the end of the Abstract -- the PEP formatting tools already create a ToC and Carol's formatting was a little off.

Note that a lot of Carol's work (but not all) was simply splitting long, dense paragraphs into bullet points while leaving all the words of the original, in the same order.

Finally, Carol left two TODOs in her text:

• After the initial paragraph of the Abstract she added a note saying "Why pattern matching". Do we want to say a thing about it here?
• At the start of "Matching process" she added a note labeled Reword which I left as a comment, suggesting there's more to be done to this section.

CC: @viridia @brandtbucher @dmoisset @Tobias-Kohn @ilevkivskyi

[dmoisset]

I generally like this, the shorter sentences and the bullets. I added a few notes

[dmoisset]

I think that "A match statement wraps sequence unpacking" may be somewhat confusing by itself (I understand the analogy we're making, but a reader may not understand this sentence is a part of an analogy).

It's slightly longer but we could try:

A match statement compares the match subject to several different shapes (patterns) until a shape fits. Each pattern describes the type and structure of the accepted values (a, b is a sequence of two elements) and variables (a and b) where to capture its contents.

[dmoisset]

I didn't add anything WRT the "why pattern matching" question, we have to discuss if we actually want to provide a separate motivation document for that

[gvanrossum]

I'm happy now (after my last few tweaks). I'll land. Anyone who disagrees can submit a new PR. :-)

[gvanrossum]

Thanks @willingc !