[Python-Dev] Python Doc problems

Josiah Carlson jcarlson at uci.edu
Sat Sep 30 01:54:10 CEST 2006


"BJörn Lindqvist" <bjourne at gmail.com> wrote:
> > If there are "rampant criticisms" of the Python docs, then those that
> > are complaining should take specific examples of their complaints to the
> > sourceforge bug tracker and submit documentation patches for the
> > relevant sections.  And personally, I've not noticed that criticisms of
> > the Python docs are "rampant", but maybe there is some "I hate Python
> > docs" newsgroup or mailing list that I'm not subscribed to.
> 
> Meh! The number one complaint IS that you have to take your complaints
> to the sourceforge bug tracker and submit documentation patches. For
> documentation changes, that is way to much overhead for to little
> gain. But thankfully I think there are people working on fixing those
> problems which is very nice.

Are you telling me that people want to be able to complain into the
ether and get their complaints heard?  I hope not, because that would be
insane.  Also, "doc patches" are basically "the function foo() should be
documented as ...", users don't need to know or learn TeX.  Should there
be an easier method of submitting doc fixes, etc.? Sure. But people are
still going to need to actually *report* the fixes they want, which they
aren't doing in *any* form now.


 - Josiah



More information about the Python-Dev mailing list