Message271471
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(). |
|
Date |
User |
Action |
Args |
2016-07-27 19:40:41 | Doug Hoskisson | set | recipients:
+ Doug Hoskisson, rhettinger, vstinner, r.david.murray, docs@python |
2016-07-27 19:40:41 | Doug Hoskisson | set | messageid: <1469648441.39.0.554786795426.issue27624@psf.upfronthosting.co.za> |
2016-07-27 19:40:41 | Doug Hoskisson | link | issue27624 messages |
2016-07-27 19:40:41 | Doug Hoskisson | create | |
|