[Christopher Blunck]
I'm new to the mailing list so I'd like to introduce myself. My name is Christopher Blunck and I'm fairly new to the Python language.
Welcome!
I am a Java developer (please do not mock me) professionally, but use Python in all of my home projects and the open source projects I contribute to.
The latter half of that sentences will stem the mocking. =)
Not sure if this is the proper forum to ask this, or if it has even been discussed before, so apologies in advance if this is inappropriate.
It's OK. Question #1 kind of isn't since it is documented on how to go about this, but Question #2 is okay to ask here.
Question #1: How can I contribute to the documentation effort?
Look around at http://www.python.org/dev/ . There is info there about how to help with the documentation effort and how to do patches to SourceForge.
Question #2: How about examples(function) that displays multiple examples of how to use the function provided? Similar to above, there are times when I look at the API and even if the parameters to the function are fully explained, it would help to have an example (case in point is os.path.walk - docs are great, but an example of how to make use of the third parameter (the arg you pass) would really clarify why 'the powers that be' chose to implement this capability.
-1 If you look in the source distribution for Python there is a directory called Demos/ that has just examples of how to use things. Stuff like what you are suggesting can go there. You can also write an examples page for the documentation. But I don't think it belongs in the language itself. If we started doing that we would take on the role of Python Cookbook and c.l.py and that is more work than we need. =) -Brett