Python docs disappointing - group effort to hire writers?

Brian Brian.Mingus at colorado.edu
Tue Aug 11 04:49:01 EDT 2009


On Fri, Jul 31, 2009 at 6:12 PM, Kee Nethery <kee at kagi.com> wrote:

> I too find the Python docs not very useful and it really slows down my
> learning curve.
>
> I wonder if it would make sense to find good tech writers, get a quotes,
> and get some professionally written documentation WITH LOTS OF EXAMPLES
> added to the standard Python documentation tree.
>
> I'd chip in money for that task. I've certainly spent enough buying Python
> books to where it would be very reasonable to chip in the cost of one book
> towards this project. Get enough people ... could be a great thing.
>
> Even though it is not the version I use, I would suggest that the really
> detailed docs with lots of examples be written against the latest python
> version.
>
> Just a thought.
>
> Kee Nethery
> --
> http://mail.python.org/mailman/listinfo/python-list
>

One thing I really like about the PHP docs is the built in forums. User
feedback on documentation is invaluable.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/python-list/attachments/20090811/e8426c94/attachment-0001.html>


More information about the Python-list mailing list