Clarify inefficiency of iterating over set literals#24002
Clarify inefficiency of iterating over set literals#24002hunterhogan wants to merge 1 commit intoastral-sh:mainfrom
Conversation
Updated documentation to clarify the inefficiency of iterating over set literals compared to list and tuple literals.
|
Could you say more about the motivation for this change? It doesn't seem like a clear improvement to me. |
|
Motivation to redraft: clarifying the rule. @amyreese proved that the text needs improvement: I read the original text, spent a couple of hours researching this, and read the comments left by @amyreese; nevertheless, my technical explanation is either the same or worse than the current draft. The writing errors and poor style in the original text did not motivate me to redraft it. The copywriting at Astral is easily the best writing in the Python ecosystem. I don't like to make claims I can't support, so I won't say it is the best I've read in all of IT. I read countless documents at Dell, for example, and when I wrote an intensive six-month training curriculum at a technical school. |
|
Thank you very much for the kind words and for looking into this! I think I'll close this for now since we don't have consensus on this being an improvement. |
Summary
Updated documentation to clarify the inefficiency of iterating over set literals compared to list and tuple literals.
Test Plan
Eyeballs