[Python-Dev] status of development documentation

Steve Holden steve at holdenweb.com
Thu Dec 22 10:27:06 CET 2005


skip at pobox.com wrote:
>     Fredrik> If you google c.l.python for the word "documentation", you'll
>     Fredrik> find recent megathreads with subjects like "bitching about the
>     Fredrik> documentation", "opensource documentation problems" and "python
>     Fredrik> documentation should be better" among the top hits.  But if you
>     Fredrik> check the bug and patch trackers, you don't find many
>     Fredrik> contributions.  Something's definitely broken.
> 
> People find it easier to complain than to contribute.  Maybe we should fix
> that problem...
> 
I very much agree that we should, and *not* by making it more difficult 
to complain ;-)

Could the PSF help here by offering annual prizes for the best 
contributions to the documentation, or wouldn't that be an adequate 
motivator?

regards
  Steve
-- 
Steve Holden       +44 150 684 7255  +1 800 494 3119
Holden Web LLC                     www.holdenweb.com
PyCon TX 2006                  www.python.org/pycon/



More information about the Python-Dev mailing list