Path: csiph.com!usenet.pasdenom.info!gegeweb.org!de-l.enfer-du-nord.net!feeder2.enfer-du-nord.net!newsfeed.eweka.nl!feeder3.eweka.nl!81.171.88.15.MISMATCH!eweka.nl!lightspeed.eweka.nl!194.134.4.91.MISMATCH!news2.euro.net!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path: <python-python-list@m.gmane.org>
X-Original-To: python-list@python.org
Delivered-To: python-list@mail.python.org
X-Spam-Status: OK 0.084
X-Spam-Evidence: '*H*': 0.83; '*S*': 0.00; 'subject:Python': 0.05; 'url:blog': 0.09; 'python': 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; 'url:tar': 0.16; 'wrote:': 0.17; 'feb': 0.19; 'url:02': 0.22; "python's": 0.23; '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; 'point': 0.31; 'url:python': 0.32; 'docs': 0.33; '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; 'serve': 0.36; 'but': 0.36; 'url:org': 0.36; 'compare': 0.36; 'should': 0.36; 'charset:us-ascii': 0.36; 'skip:p 20': 0.36; 'bad': 0.37; 'subject:: ': 0.38; 'speak': 0.38; 'url:docs': 0.38; 'there,': 0.38; 'url:en': 0.38; 'to:addr:python.org': 0.39; 'header:Received:5': 0.40; 'think': 0.40; 'valuable': 0.60; 'url:index': 0.61; 'biggest': 0.71; 'url:wordpress': 0.75; '2013': 0.84; 'banned': 0.84; 'locally': 0.84; 'received:sd.cox.net': 0.84; 'strengths,': 0.84; 'suggests.': 0.84; 'titled:': 0.84; 'url:2013': 0.84; 'url:posts': 0.84; 'url:php': 0.86; 'subject:you': 0.88
X-Injected-Via-Gmane: http://gmane.org/
Mail-Followup-To: python-list@python.org
To: python-list@python.org
From: rh <richard_hubbe11@lavabit.com>
Subject: Re: Do you feel bad because of the Python docs?
Date: Tue, 26 Feb 2013 18:06:21 -0800
References: <512cb0a0$0$30001$c3e8da3$5496439d@news.astraweb.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=US-ASCII
Content-Transfer-Encoding: 7bit
X-Gmane-NNTP-Posting-Host: ip68-227-87-145.sb.sd.cox.net
User-Agent: dsodnetnin
X-Mailer: EZnn0.37p
X-Newsreader: EZnn0.37p
X-Gmane-NNTP-Posting-Host: EZnn0.37p
Original-Received: from slem by 1.1 with local
X-No-Archive: yes
Archive: no
X-Archive: expiry=11
X-Archive: encrypt
X-Operating-System: Barebones_6.1
X-Gmane-NNTP-Posting-Host: 192.168.1.1
X-NNTP-Posting-Host: 192.168.1.1
Mail-Copies-To: never
X-BeenThere: python-list@python.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: General discussion list for the Python programming language <python-list.python.org>
List-Unsubscribe: <http://mail.python.org/mailman/options/python-list>, <mailto:python-list-request@python.org?subject=unsubscribe>
List-Archive: <http://mail.python.org/pipermail/python-list/>
List-Post: <mailto:python-list@python.org>
List-Help: <mailto:python-list-request@python.org?subject=help>
List-Subscribe: <http://mail.python.org/mailman/listinfo/python-list>, <mailto:python-list-request@python.org?subject=subscribe>
Newsgroups: comp.lang.python
Message-ID: <mailman.2588.1361930758.2939.python-list@python.org>
Lines: 48
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1361930758 news.xs4all.nl 6915 [2001:888:2000:d::a6]:55649
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:40023

On 26 Feb 2013 12:54:56 GMT
Steven D'Aprano <steve+comp.lang.python@pearwood.info> 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/

FWIW,  I refer to the docs often. I keep a local copy and
serve the pages up locally

1. http://docs.python.org/2/archives/python-2.7.3-docs-html.tar.bz2
2. unroll
3. cd python-2.7.3-docs-html
4. python -c 'import SimpleHTTPServer as foo;foo.test()' 9292
5. point browser to 0:9292


> 
> 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
> 
> 
> 
> -- 
> Steven


--