Social problems of Python doc [was Re: Python docs disappointing]

Cousin Stanley cousinstanley at gmail.com
Wed Aug 12 22:21:25 EDT 2009



> FWIW, I support the idea the regular docs incorporating links 
> to freely editable wiki pages.  That will at least make it 
> easier for people to make changes or add notes.
>
> That being said, I would like to add a few thoughts about the
> current process.   ISTM that important corrections (when the
> docs are clearly in error) tend to get made right away.  What
> is more interesting are the doc requests that get rejected
> and why:
> ....
> In short, most doc requests that get rejected are requests 
> that didn't actually improve the documentation.
> .... 

Raymond ....

  Thanks for your very eloquent and cohernt response
  that in my opinion helps to explain many of the 
  problems, either real or perceived, with the Python
  documentation ....


-- 
Stanley C. Kitching
Human Being
Phoenix, Arizona




More information about the Python-list mailing list