[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