[docs] [issue27624] unclear documentation on Queue.qsize()
report at bugs.python.org
Wed Jul 27 15:40:41 EDT 2016
Doug Hoskisson added the comment:
My suggestion was not to delete the "approximate" entirely. Just move it out of the first sentence to make it more consistent with the other documentation.
This is the model I'm seeing in empty() and full():
The first sentence is something simple and direct (without nebulous words that will make people wonder what it means), and then after that, comment on the race-condition stuff.
I think that documentation is good, and it would be good to follow the same model for qsize().
Python tracker <report at bugs.python.org>
More information about the docs