Python docs disappointing - group effort to hire writers?

Terry Reedy tjreedy at udel.edu
Thu Aug 6 09:55:04 EDT 2009


RayS wrote:
> At 08:35 PM 8/5/2009 -0700, r wrote:
>> """... Any real sense of community is undermined -- or
>> even destroyed -- to be replaced by virtual equivalents that strive,
>> unsuccessfully, to synthesize a sense of community."""
> 
> I've brought up the idea of the quasi-community doc that PHP uses to 
> good effect.

And what have you done about setting up such a project?

> http://www.php.net/manual/en/language.types.array.php is a prime example 
> where 2/3 of the "doc" is user-contributed comments and code.

I consider consider this to an unreadable mishmash. If you and others 
want something like that, do it.  And quite bitching about the work of 
those of us who have done something compact and readable. We are all 
volunteers here.

tjr




More information about the Python-list mailing list