Path: csiph.com!usenet.pasdenom.info!weretis.net!feeder1.news.weretis.net!feeder.erje.net!eu.feeder.erje.net!eweka.nl!lightspeed.eweka.nl!194.109.133.86.MISMATCH!newsfeed.xs4all.nl!newsfeed3.news.xs4all.nl!xs4all!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.055 X-Spam-Evidence: '*H*': 0.89; '*S*': 0.00; 'subject:Python': 0.05; 'python': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; '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; 'header:User-Agent:1': 0.26; 'wrote': 0.26; 'replace': 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; 'to:addr:python-list': 0.33; 'community': 0.35; 'subject:?': 0.35; 'received:org': 0.36; 'serve': 0.36; 'url:org': 0.36; 'compare': 0.36; 'should': 0.36; 'charset:us-ascii': 0.36; 'skip:p 20': 0.36; 'subject:: ': 0.38; 'url:docs': 0.38; 'url:en': 0.38; 'to:addr:python.org': 0.39; 'step': 0.39; 'header:Received:5': 0.40; 'valuable': 0.60; 'url:index': 0.61; 'url:wordpress': 0.75; '2013': 0.84; 'locally': 0.84; 'received:sd.cox.net': 0.84; 'titled:': 0.84; 'url:2013': 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 Subject: Re: Do you feel bad because of the Python docs? Date: Mon, 4 Mar 2013 08:59:06 -0800 References: <512cb0a0$0$30001$c3e8da3$5496439d@news.astraweb.com> <20130226180621.5e038f7c0ac9fbf916166807@lavabit.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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: Lines: 32 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1362416312 news.xs4all.nl 6929 [2001:888:2000:d::a6]:54171 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:40466 On Tue, 26 Feb 2013 18:06:21 -0800 rh wrote: > On 26 Feb 2013 12:54:56 GMT > Steven D'Aprano +I/owrrOrA@public.gmane.org> 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 I find that this works now to replace step #4: python -m SimpleHTTPServer 9292