
On 01/06/2015 05:16 PM, Stephen J. Turnbull wrote:
Ethan Furman writes:
On 01/06/2015 02:11 PM, Wes Turner wrote:
A boost in familiar usability could encourage effortless contributions.
Not even breathing is effortless.
True, but that's the wrong fallacy. [...]
The fallacy in applying wiki-think to Python is that [an] *increase in quantity* of documentation is [not necessarily an] *improvement in quality* of documentation. [...]
It isn't even clear that filling an obvious hole with an accurate-as- far-as-it-goes drive-by contribution is a good thing. Not only may the residual inaccuracy mislead the reader, it may also contribute to an impression that the Python docs are lower quality on average than they actually are.
Thanks -- that's worded much better than my own feeble attempt. :) -- ~Ethan~