3 ms·
Seems like a worthwhile initiative (and it appears that Mozilla agrees). A suggestion: perhaps it would be worth focusing on the Python standard library, at le
by spangry 10y ago
Seems like a worthwhile initiative (and it appears that Mozilla agrees).
A suggestion: perhaps it would be worth focusing on the Python standard library, at least initially? I find the 'narrative style' and the code examples in the current documentation is often unhelpful and confusing. And it's such a shame; there's so much good functionality in the standard library. This is just from the perspective of a relative novice, but examples like this (https://docs.python.org/3/library/concurrent.futures.html#concurrent.futures.ProcessPoolExecutor https://docs.python.org/3/library/concurrent.futures.html#co...) are extremely hard to follow because too many concepts (some of which are irrelevant) are all introduced at the same time. I often find myself skipping the official documentation all together and going straight to somewhere like PMOTW or stackoverflow.
Also, focusing on the standard library could be a good way to provide a 'best practice' example that the community could follow.