Path: csiph.com!usenet.pasdenom.info!weretis.net!feeder4.news.weretis.net!ecngs!feeder2.ecngs.de!newsfeed.freenet.ag!news2.euro.net!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail Return-Path: X-Original-To: python-list@python.org Delivered-To: python-list@mail.python.org X-Spam-Status: OK 0.093 X-Spam-Evidence: '*H*': 0.81; '*S*': 0.00; 'subject:Python': 0.05; 'url:blog': 0.09; 'python': 0.09; 'lawrence': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; '(well,': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'wrote:': 0.17; 'url:02': 0.22; "python's": 0.23; 'header:In- Reply-To:1': 0.25; 'header:User-Agent:1': 0.26; 'wrote': 0.26; 'core': 0.27; 'header:X-Complaints-To:1': 0.28; 'post': 0.28; "d'aprano": 0.29; 'steven': 0.29; '"the': 0.29; 'url:python': 0.32; 'from:addr:yahoo.co.uk': 0.32; 'doubt': 0.33; 'to:addr :python-list': 0.33; 'another': 0.33; 'community': 0.35; 'subject:?': 0.35; "won't": 0.35; 'received:org': 0.36; 'really': 0.36; 'but': 0.36; 'url:org': 0.36; 'compare': 0.36; 'should': 0.36; 'bad': 0.37; 'subject:: ': 0.38; 'mark': 0.38; 'speak': 0.38; 'there,': 0.38; 'url:en': 0.38; 'to:addr:python.org': 0.39; 'header:Received:5': 0.40; 'help': 0.40; 'think': 0.40; 'valuable': 0.60; 'leading': 0.61; 'url:index': 0.61; 'world': 0.63; 'experts': 0.66; 'biggest': 0.71; 'url:info': 0.75; 'url:wordpress': 0.75; 'banned': 0.84; 'strengths,': 0.84; 'suggests.': 0.84; 'titled:': 0.84; 'url:2013': 0.84; 'url:posts': 0.84; 'url:xahlee': 0.84; 'url:php': 0.86; 'subject:you': 0.88 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Mark Lawrence Subject: Re: Do you feel bad because of the Python docs? Date: Wed, 27 Feb 2013 09:47:41 +0000 References: <512cb0a0$0$30001$c3e8da3$5496439d@news.astraweb.com> Mime-Version: 1.0 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit X-Gmane-NNTP-Posting-Host: host-92-18-29-221.as13285.net User-Agent: Mozilla/5.0 (Windows NT 6.0; rv:17.0) Gecko/20130215 Thunderbird/17.0.3 In-Reply-To: <512cb0a0$0$30001$c3e8da3$5496439d@news.astraweb.com> X-Antivirus: avast! (VPS 130226-1, 26/02/2013), Outbound message X-Antivirus-Status: Clean X-BeenThere: python-list@python.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: General discussion list for the Python programming language List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 34 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1361958444 news.xs4all.nl 6923 [2001:888:2000:d::a6]:40806 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:40042 On 26/02/2013 12:54, Steven D'Aprano wrote: > One week ago, "JoePie91" wrote a blog post challenging the Python > community and the state of Python documentation, titled: > > "The Python documentation is bad, and you should feel bad". > > http://joepie91.wordpress.com/2013/02/19/the-python-documentation-is-bad- > and-you-should-feel-bad/ > > It is valuable to contrast and compare the PHP and Python docs: > > http://php.net/manual/en/index.php > http://www.python.org/doc/ > > There's no doubt that one of PHP's strengths, perhaps its biggest > strength, is the good state of documentation. But should we feel bad > about Python's docs? I don't think that either the Python documentation > or community is as bad as JoePie91 suggests. (Well, I won't speak for the > people on Freenode's #python. It took me approximately three minutes to > be banned from there, with no warning or explanation.) > > Another response to the blog post, by one of the core developers: > > http://blog.briancurtin.com/posts/why-i-dont-feel-so-bad.html > Not really when we've got world leading experts to help us out http://xahlee.info/perl-python/python_doc.html :) * sys.maxint -- Cheers. Mark Lawrence