<div>I am a newbie and about a month old with Python. There is a wealth of material about Python and I am really enjoying learning Python.</div>
<div> </div>
<div>One thing that could have helped Python documentation is that instead of the very "raw" doc string, it could have used something like PythonDoc (java doc style) so that the functions/classes are documented better. At least I am planning to use PythonDoc for the code that I am going to write. Let me know if there is a better one..</div>

<div> </div>
<div>-mohan<br><br></div>
<div class="gmail_quote">On Fri, Jul 31, 2009 at 1:10 PM, kj <span dir="ltr"><no.email@please.post></span> wrote:<br>
<blockquote class="gmail_quote" style="PADDING-LEFT: 1ex; MARGIN: 0px 0px 0px 0.8ex; BORDER-LEFT: #ccc 1px solid"><br><br><br>I'm pretty new to Python, and I like a lot overall, but I find the<br>documentation for Python rather poor, overall.<br>
<br>I'm sure that Python experts don't have this problem: they have<br>internalized some good ways to access the documentation, are<br>productive with it, and therefore have lost the ability to see why<br>the Python documentations is deficient for beginners.  This explains<br>
why a suboptimal situation can persist like this: those who are<br>most able fix it are also the least able to perceive it.<br><br>I've heard similar complaints from other experienced programmers<br>who are trying out Python for the first time: poor documentation.<br>
<br>Here is an *entirely typical* example: on some Unix, try<br><br>% pydoc urllib<br><br>The displayed documentation mention the optional parameter "data"<br>in practically every function listed (a few dozen of them).  This<br>
parameter is not documented *anywhere* on that page.  All that we<br>are told is that its default value is always None.<br><br>I'm sure that I can find a full description of this parameter if<br>I fire up Google, and search online.  In fact, more likely than<br>
not, I'll find far more documentation than I want.  But my point<br>is that a programmer should not need to do this.  The full<br>documentation should be readily accessible directly through a few<br>keystrokes.<br><br>
I would love to know how experienced Python programmers quickly<br>zero in on the Python documentation they need.<br><br>TIA!<br><br>kynn<br><font color="#888888">--<br><a href="http://mail.python.org/mailman/listinfo/python-list" target="_blank">http://mail.python.org/mailman/listinfo/python-list</a><br>
</font></blockquote></div><br>