[Python-ideas] Rewriting the "roundrobin" recipe in the itertools documentation

Ethan Furman ethan at stoneleaf.us
Thu Nov 16 14:57:51 EST 2017


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~



More information about the Python-ideas mailing list