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: 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> <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 To: "python-list (General)" 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Newsgroups: comp.lang.python Message-ID: 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 On Wed, Aug 21, 2013 at 1:55 PM, 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