News for hackers. Stuff that matters.
Re:I Like PHP by otterley on Wednesday August 10, 2011 @02:32PM (#2869531)
Python itself does, but the third party modules (which do most of the heavy lifting) generally don't. See: Twisted.
Re:I Like PHP by jrockway on Wednesday August 10, 2011 @05:57PM (#2870396)
Perl is a good example where most third-party modules have good documentation. Or at least a SYNOPSIS you can poke, some DESCRIPTION of what the module does, and a few hundred lines of code in the t/ directory that test all the features of the modules.

The one thing I miss in Python is the inability to click "view source" in my web browser to see how a core Python library is implemented. PHP also has this problem. (Code is the best documentation. Learn to read it.)

Re:I Like PHP by shabble on Thursday August 11, 2011 @01:28AM (#2871546)
If you're talking about the search.cpan.org links to source, I'm right there with you.

The only thing I wish they had was a way to pipe it through a highlighter like perltidy with html out. That'd probably just lead to holy wars on formatting/colours though.

Re:I Like PHP by draegtun on Thursday August 11, 2011 @06:05AM (#2872170)
Re:I Like PHP by shabble on Thursday August 11, 2011 @06:23AM (#2872195)
Awesome. search aliases duly updated.
Re:I Like PHP by wulczer on Wednesday August 10, 2011 @04:47PM (#2870115)
Twisted has semi-decent documentation, see

http://twistedmatrix.com/documents/current/api/twisted.html

http://twistedmatrix.com/documents/current/core/howto/index....

http://twistedmatrix.com/trac/wiki/Documentation

It's not as comprehensive and shiny as the core Python docs, but along with the tutorials and examples, it's actually pretty decent.

Re:I Like PHP by masklinn on Thursday August 11, 2011 @05:25AM (#2872093)
There's high variation in quality amongst third-party modules, but the "modern" python community takes documentation quite seriously, there's even a complete site dedicated to nothing but hosting compiled documentation[0]. Projects like Django, Flask, SQLAlchemy or Flask have rather good documentation sets.

[0] http://rtfd.org

Re:I Like PHP by twism on Wednesday August 10, 2011 @02:35PM (#2869549)
Third party documentation doesn't count in this discussion.
Re:I Like PHP by ceejayoz on Wednesday August 10, 2011 @02:43PM (#2869607)
It does when one of the big criticisms of PHP is that it rolls everything into core that'd normally be third-party.
Re:I Like PHP by bad_user on Wednesday August 10, 2011 @04:19PM (#2869991)
Considering how PHP doesn't have anything like Twisted (and this is just one example out of many) ; no, it doesn't count.

Also, I never used a popular Python library for which I haven't found good resources.

My favorite Python library, called NLTK, which has no equivalent in PHP or Ruby or any other platform for that matter, comes with a freaking book that's available for free.