On 11/16/2017 05:56 AM, bunslow wrote:
I realize at the end of the day this is a pretty trivial and ultimately meaningless nit to pick,
Not at all -- documentation is extremely important.
but I've never contributed before and have a variety of similar minor pain points in the docs/stdlib, and I'm trying to gauge 1) how well this sort of minor QoL improvement is wanted, and 2) even if it is wanted, am I going about it the right way. If the answers to both of these questions are positive regarding this particular case, then I'll look into making a BPO issue and pull request on GitHub, which IIUC is the standard path for contributions.
I found your example much easier to understand. Just include a note the the "roughly similar" python code is not performant in extreme situations; after all, it's there to aid understanding, not to be used.
-- ~Ethan~ _______________________________________________ Python-ideas mailing list Python-ideas@python.org https://mail.python.org/mailman/listinfo/python-ideas Code of Conduct: http://python.org/psf/codeofconduct/