On Saturday 16 September 2006 19:16, [EMAIL PROTECTED] wrote: > I am a bit disapointed with the current Python online documentation. I > have read many messages of people complaining about the documentation, > it's lack of examples and the use of complicated sentences that you > need to read 10 times before understanding what it means. > > That's why I have started a collaborative project to make a user > contributed Python documentation. The wiki is online here: > http://www.pythondocs.info > > This is a fresh new website, so there's not much on it, but I hope to > make it grow quickly. Help and contributions are welcome; Please > register and start posting your own documentation on it.
I like your enthusiasm but it appears that what you plan is similar to the Python Quick Reference at http://rgruet.free.fr/ I second that the Python documentation is lacking. There is no software that is adequately documented anyway. Show me a man page of a Perl module and it takes me minutes to use it. The same in Python often means Google to find some examples on how to use a module. Many parts of the standard library are badly documented IMHO. There is often no way to know how to use a certain module without looking at its source. But why don't you and I rather provide patches to the current documentation rather than writing yet another incomplete resource. IMHO python.org should be completed. And at least you motivated me to look for ways to contribute to python.org. :) Cheers Christoph -- http://mail.python.org/mailman/listinfo/python-list
