[Python-ideas] Encouraging more use of the Python wiki

Ethan Furman ethan at stoneleaf.us
Wed Jan 7 02:28:13 CET 2015


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~

-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 836 bytes
Desc: OpenPGP digital signature
URL: <http://mail.python.org/pipermail/python-ideas/attachments/20150106/dc41c9c2/attachment.sig>


More information about the Python-ideas mailing list