Path: csiph.com!newsfeed.hal-mli.net!feeder3.hal-mli.net!newsfeed.hal-mli.net!feeder1.hal-mli.net!newsfeed.xs4all.nl!newsfeed1.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.004 X-Spam-Evidence: '*H*': 0.99; '*S*': 0.00; '21,': 0.07; 'pep': 0.09; 'received:internal': 0.09; 'api': 0.11; 'python': 0.11; 'compliant,': 0.16; 'message-id:@webmail.messagingengine.com': 0.16; 'personally,': 0.16; 'received:10.202': 0.16; 'received:10.202.2': 0.16; 'received:66.111': 0.16; 'received:66.111.4': 0.16; 'received:66.111.4.27': 0.16; 'received:messagingengine.com': 0.16; 'received:out3-smtp.messagingengine.com': 0.16; 'subject:PEPs': 0.16; 'subject:download': 0.16; 'subject:included': 0.16; 'wrote:': 0.18; 'wed,': 0.18; 'basically': 0.19; '(the': 0.22; 'aug': 0.22; "i've": 0.25; 'header:In-Reply-To:1': 0.27; 'that.': 0.31; 'style': 0.33; 'to:name:python-list': 0.33; 'maybe': 0.34; 'subject:the': 0.34; 'received:66': 0.35; 'subject:with': 0.35; 'beyond': 0.35; 'there': 0.35; 'subject:skip:d 10': 0.36; "didn't": 0.36; 'material': 0.36; 'should': 0.36; 'received:10': 0.37; 'to:addr:python-list': 0.38; 'to:addr:python.org': 0.39; 'from:no real name:2**0': 0.61; 'header:Message-Id:1': 0.63; 'such': 0.63; '..net': 0.84; '2013,': 0.91; 'hill': 0.95 DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d=fastmail.us; h= message-id:from:to:mime-version:content-transfer-encoding :content-type:subject:date:in-reply-to:references; s=mesmtp; bh= 2ROdoky8eoDfomJg+uKtwM/8u3k=; b=KRs4Ewkc0lIj1BRy+Kq0moJrOjx6AJAs TJotEUcQFkXJVQ76YlUrAnsX+vvl+vB0ubLhl+GqSEdHiYaqN2R+mpFN0IJ4xcVV 1FqR1LFfOTVCfN1EdAll1ONr4DHnM9hL2YnpbgfvoLHfoPuaqyifavmyVvRIJHiz fKjX33BN3TQ= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed/relaxed; d= messagingengine.com; h=message-id:from:to:mime-version :content-transfer-encoding:content-type:subject:date:in-reply-to :references; s=smtpout; bh=2ROdoky8eoDfomJg+uKtwM/8u3k=; b=VmoMC vRGQEeccqXLHpAKFIh/83jUxA0LznHCQyX3aRmOzrPHfQ1TNhnpIGUQIeKRejM69 EtyjYwSzY9IFRMfwQ7j0jEeNzaqAQzFr2EKnOCWEe/4VdmWrt/l2CmBuhwgwC0fz hxI+11KjH/IxAvN93Cjm3C7Jkr3fygugJ0yT80= X-Sasl-Enc: irACOMcQ7g6L/W6CrG6h/7NevIyab1IOjSw8HCf4EF+E 1377109696 From: random832@fastmail.us To: "python-list" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Content-Type: text/plain X-Mailer: MessagingEngine.com Webmail Interface - ajax-d009844e Subject: Re: PEPs should be included with the documentation download Date: Wed, 21 Aug 2013 14:28:16 -0400 In-Reply-To: References: <4bc4d258-1e12-4e1a-af9c-0019f099612f@googlegroups.com> <1377107744.21484.12540441.3FF11C64@webmail.messagingengine.com> 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: 10 NNTP-Posting-Host: 2001:888:2000:d::a6 X-Trace: 1377109708 news.xs4all.nl 15922 [2001:888:2000:d::a6]:41218 X-Complaints-To: abuse@xs4all.nl Xref: csiph.com comp.lang.python:52782 On Wed, Aug 21, 2013, at 14:15, Jerry Hill wrote: > 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. Maybe there should be documentation for PEP 249 and other such "API Specifications" in the main documentation tree, in the same way that .NET documents interfaces.