5 ms·
Python itself does, but the third party modules (which do most of the heavy lifting) generally don't. See: Twisted.
by otterley 15y ago
Python itself does, but the third party modules (which do most of the heavy lifting) generally don't. See: Twisted.
- twism 15y agoThird party documentation doesn't count in this discussion.
- ceejayoz 15y agoIt does when one of the big criticisms of PHP is that it rolls everything into core that'd normally be third-party.
- bad_user 15y agoConsidering 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.
- wulczer 15y agoTwisted has semi-decent documentation, see http://twistedmatrix.com/documents/current/api/twisted.html http://twistedmatrix.com/documents/current/api/twisted.html http://twistedmatrix.com/documents/current/core/howto/index.html http://twistedmatrix.com/documents/current/core/howto/index.... http://twistedmatrix.com/trac/wiki/Documentation 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.
- jrockway 15y agoPerl 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.)
- shabble 15y agoIf 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.
- masklinn 15y agoThere'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 http://rtfd.org