Path: csiph.com!v102.xanadu-bbs.net!xanadu-bbs.net!feeder.erje.net!eu.feeder.erje.net!newsreader4.netcologne.de!news.netcologne.de!xlned.com!feeder7.xlned.com!newsfeed.xs4all.nl!newsfeed4.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.002 X-Spam-Evidence: '*H*': 1.00; '*S*': 0.00; 'think,': 0.07; 'pep': 0.09; 'received:80.91': 0.09; 'received:80.91.229': 0.09; 'received:gmane.org': 0.09; 'received:list': 0.09; 'bug': 0.12; 'message-id:@4ax.com': 0.16; 'received:80.91.229.3': 0.16; 'received:plane.gmane.org': 0.16; 'remedied': 0.16; 'routinely': 0.16; 'slough': 0.16; 'subject:PEPs': 0.16; 'subject:download': 0.16; 'subject:included': 0.16; 'wed,': 0.18; 'aug': 0.22; 'url:home': 0.24; 'header:X-Complaints-To:1': 0.27; 'explained': 0.31; 'supposed': 0.32; 'subject:the': 0.34; 'subject:with': 0.35; 'but': 0.35; 'skip:> 10': 0.36; 'subject:skip:d 10': 0.36; 'useful': 0.36; 'charset:us-ascii': 0.36; 'should': 0.36; 'received:76': 0.38; 'to:addr:python-list': 0.38; 'though,': 0.39; 'to:addr:python.org': 0.39; 'received:org': 0.40; 'information': 0.63; '2013': 0.98 X-Injected-Via-Gmane: http://gmane.org/ To: python-list@python.org From: Dennis Lee Bieber Subject: Re: PEPs should be included with the documentation download Date: Wed, 21 Aug 2013 20:27:03 -0400 Organization: IISS Elusive Unicorn References: <4bc4d258-1e12-4e1a-af9c-0019f099612f@googlegroups.com> <1377107744.21484.12540441.3FF11C64@webmail.messagingengine.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit X-Gmane-NNTP-Posting-Host: adsl-76-249-30-163.dsl.klmzmi.sbcglobal.net X-Newsreader: Forte Agent 6.00/32.1186 X-No-Archive: YES 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: 16 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1377131229 news.xs4all.nl 15871 [2001:888:2000:d::a6]:41207 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:52801 On Wed, 21 Aug 2013 13:55:44 -0400, random832@fastmail.us declaimed the following: >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. The only PEP I routinely reference is the one covering the DB-API (2). Since many of the DB adapters are supposed to follow it, and may actually slough off documentation to that PEP. -- Wulfraed Dennis Lee Bieber AF6VN wlfraed@ix.netcom.com HTTP://wlfraed.home.netcom.com/