Re: PEPs should be included with the documentation download

Path	csiph.com!usenet.pasdenom.info!aioe.org!news.stack.nl!newsfeed.xs4all.nl!newsfeed3.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path	<malaclypse2@gmail.com>
X-Original-To	python-list@python.org
Delivered-To	python-list@mail.python.org
X-Spam-Status	OK 0.003
X-Spam-Evidence	'H': 0.99; 'S': 0.00; '21,': 0.07; 'think,': 0.07; 'pep': 0.09; 'api': 0.11; 'python': 0.11; 'bug': 0.12; 'sections': 0.14; 'compliant,': 0.16; 'personally,': 0.16; 'remedied': 0.16; 'subject:PEPs': 0.16; 'subject:download': 0.16; 'subject:included': 0.16; 'language': 0.16; 'wrote:': 0.18; 'wed,': 0.18; 'basically': 0.19; 'seems': 0.21; '(the': 0.22; 'aug': 0.22; "i've": 0.25; 'compiled': 0.26; 'least': 0.26; 'header:In-Reply-To:1': 0.27; 'message-id:@mail.gmail.com': 0.30; 'that.': 0.31; 'embedding': 0.31; 'explained': 0.31; 'extending': 0.31; 'style': 0.33; 'subject:the': 0.34; 'subject:with': 0.35; 'beyond': 0.35; 'but': 0.35; 'received:google.com': 0.35; 'subject:skip:d 10': 0.36; "didn't": 0.36; 'material': 0.36; 'useful': 0.36; 'should': 0.36; 'to:addr:python-list': 0.38; 'pm,': 0.38; 'though,': 0.39; 'to:addr:python.org': 0.39; 'information': 0.63; 'obtained': 0.96; '2013': 0.98
DKIM-Signature	v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20120113; h=mime-version:in-reply-to:references:date:message-id:subject:from:to :content-type; bh=P61AERze+TDbtgo7LjQK5GWr9GUgHHxX1TuQtGNB0zk=; b=bScCgLtNB+WROgPVAWqvW7+CCbEurZzXgdIqc8q4wBTD28fkhS1v9bOojATta2pHp3 tr8RFOURXJJuqjum3zs39OgBHYUl81eFjcY/9dDLmRVnapoD9gk+FGZ4NuZCvRLhE4aZ zqUsl9s5OcECpSatsYNYzL5e0H7mrsY0pPbFB/+LYgQoebBQevedapQGe0jdhJL/G/85 ls8VrNmIvhXBhhsmrKQYtFdQ9kJtQZ64AxYaJBAOc9kQEjcXeVu6j/USjIW7BOVEZrk/ iHDzyftJ3BaMT/E3Q/S4CvmNBYH2REu7LX4RlUtAGpfcool++9wt8f4vyierwTe3wL03 dzxg==
MIME-Version	1.0
X-Received	by 10.68.191.36 with SMTP id gv4mr1028838pbc.167.1377108937486; Wed, 21 Aug 2013 11:15:37 -0700 (PDT)
In-Reply-To	<1377107744.21484.12540441.3FF11C64@webmail.messagingengine.com>
References	<4bc4d258-1e12-4e1a-af9c-0019f099612f@googlegroups.com> <CAPTjJmoCwWk_n-rsxy9gJfJakcnoD8=9p6uFduSJALHzGs5n_A@mail.gmail.com> <1377107744.21484.12540441.3FF11C64@webmail.messagingengine.com>
Date	Wed, 21 Aug 2013 14:15:37 -0400
Subject	Re: PEPs should be included with the documentation download
From	Jerry Hill <malaclypse2@gmail.com>
To	"python-list (General)" <python-list@python.org>
Content-Type	text/plain; charset=UTF-8
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.92.1377109280.19984.python-list@python.org> (permalink)
Lines	19
NNTP-Posting-Host	2001:888:2000:d::a6
X-Trace	1377109280 news.xs4all.nl 15889 [2001:888:2000:d::a6]:35636
X-Complaints-To	abuse@xs4all.nl
Xref	csiph.com comp.lang.python:52780

Show key headers only | View raw

On Wed, Aug 21, 2013 at 1:55 PM,  <random832@fastmail.us> wrote:
> I think, though, that if there's any useful information that can be
> obtained by reading accepted PEPs but not the documentation, or if
> things are explained less clearly than in the PEPs, that's a bug in the
> documentation, and should be remedied by adding to the documentation.

Personally, the only PEPs I've used as reference material as PEP 8
(the Python Style Guide), and PEP 249 (the Python Database API
Specification v2.0).  If I recall correctly, one of the database
adapters I used basically said that they were PEP 249 compliant, and
didn't have much documentation beyond that.

It seems to me that adding the PEPs to the compiled documentation
would be a good thing.  They are at least as useful as the Language
Reference or the Embedding and Extending Python sections that are
already included.

-- 
Jerry

Thread

PEPs should be included with the documentation download Aseem Bansal <asmbansal2@gmail.com> - 2013-08-20 22:14 -0700
  Re: PEPs should be included with the documentation download Chris Angelico <rosuav@gmail.com> - 2013-08-22 03:32 +1000
    Re: PEPs should be included with the documentation download Aseem Bansal <asmbansal2@gmail.com> - 2013-08-22 01:39 -0700
      Re: PEPs should be included with the documentation download Terry Reedy <tjreedy@udel.edu> - 2013-08-22 18:46 -0400
  Re: PEPs should be included with the documentation download random832@fastmail.us - 2013-08-21 13:55 -0400
    Re: PEPs should be included with the documentation download Aseem Bansal <asmbansal2@gmail.com> - 2013-08-22 01:45 -0700
  Re: PEPs should be included with the documentation download Jerry Hill <malaclypse2@gmail.com> - 2013-08-21 14:15 -0400
  Re: PEPs should be included with the documentation download random832@fastmail.us - 2013-08-21 14:28 -0400
  Re: PEPs should be included with the documentation download Chris Angelico <rosuav@gmail.com> - 2013-08-22 04:50 +1000
  Re: PEPs should be included with the documentation download Terry Reedy <tjreedy@udel.edu> - 2013-08-21 16:15 -0400
  Re: PEPs should be included with the documentation download Dennis Lee Bieber <wlfraed@ix.netcom.com> - 2013-08-21 20:27 -0400
  Re: PEPs should be included with the documentation download Ben Finney <ben+python@benfinney.id.au> - 2013-08-23 11:47 +1000
  Re: PEPs should be included with the documentation download Chris Angelico <rosuav@gmail.com> - 2013-08-23 11:54 +1000
    Re: PEPs should be included with the documentation download Neil Cerutti <neilc@norwich.edu> - 2013-08-23 13:19 +0000
  Re: PEPs should be included with the documentation download Ben Finney <ben+python@benfinney.id.au> - 2013-08-23 16:21 +1000
  Re: PEPs should be included with the documentation download Ned Deily <nad@acm.org> - 2013-08-23 01:14 -0700
  Re: PEPs should be included with the documentation download Ben Finney <ben+python@benfinney.id.au> - 2013-08-23 19:24 +1000

csiph-web