Path: csiph.com!usenet.pasdenom.info!goblin2!goblin.stu.neva.ru!newsfeed.xs4all.nl!newsfeed1.news.xs4all.nl!xs4all!post.news.xs4all.nl!not-for-mail
Return-Path: <random832@fastmail.us>
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; 'python.': 0.02; 'offline': 0.03; '21,': 0.07; 'think,': 0.07; 'received:internal': 0.09; 'rejected': 0.09; 'python': 0.11; 'bug': 0.12; 'suggest': 0.14; 'docs.': 0.16; 'message-id:@webmail.messagingengine.com': 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; 'remedied': 0.16; 'subject:PEPs': 0.16; 'subject:download': 0.16; 'subject:included': 0.16; 'wrote:': 0.18; 'wed,': 0.18; 'all,': 0.19; 'help.': 0.21; 'aug': 0.22; 'certainly': 0.24; 'somewhere': 0.26; 'header:In-Reply-To:1': 0.27; 'point': 0.28; 'chris': 0.29; 'included': 0.31; 'explained': 0.31; 'subject:the': 0.34; 'received:66': 0.35; 'subject:with': 0.35; 'but': 0.35; 'really': 0.36; 'subject:skip:d 10': 0.36; 'useful': 0.36; 'should': 0.36; 'received:10': 0.37; 'being': 0.38; 'to:addr:python-list': 0.38; 'pm,': 0.38; 'rather': 0.38; 'though,': 0.39; 'to:addr:python.org': 0.39; 'how': 0.40; 'most': 0.60; 'from:no real name:2**0': 0.61; 'simply': 0.61; "you've": 0.63; 'header :Message-Id:1': 0.63; 'information': 0.63; 'laptop': 0.65; 'downloadable': 0.84; 'end-user': 0.84; '2013,': 0.91; 'crucial': 0.91; 'download.': 0.91; 'obtained': 0.96; '2013': 0.98
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:in-reply-to:references:subject:date; s=mesmtp; bh= j1UKgwZLn+gVfJaWWRlSV3qcS1g=; b=TmZEtAl1FQUE2iKX6r1rlhWhFv9RGC19 DsBiJhdvtoYf/YenWl2p4LqORfX+SyXZlncgOhGd35W2dIyKYuv9Nfv5K8Tpn1T0 vzkjiSUeeX6RXn+t8RNL+2KARumMExljPZhgDuZk2jNFT2wSLoSZyCbgP9ZmmQM9 RrEXH8Sxrr4=
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:in-reply-to:references :subject:date; s=smtpout; bh=j1UKgwZLn+gVfJaWWRlSV3qcS1g=; b=Vzs GT5v77GVCFdDWw5BTS5QviAFHGxSpUNgIoaEjNsZsmSBiqRb5H+WLo3Sio6fRaPe N7QrrUyjC9iUA714ul01v7lQa9bg0eWvc7NmjoFlcgi09ch0lWc2XZQ5+DknrIhy E6M2oWLAkajMEqO7F8WgrEE6Lg/WgyJ6uIMU3Blc=
X-Sasl-Enc: yVf7fnQjHOQTJIaHROekAYGOad/4ILZ8Lb/KPYMMVFNf 1377107744
From: random832@fastmail.us
To: python-list@python.org
MIME-Version: 1.0
Content-Transfer-Encoding: 7bit
Content-Type: text/plain
X-Mailer: MessagingEngine.com Webmail Interface - ajax-d009844e
In-Reply-To: <CAPTjJmoCwWk_n-rsxy9gJfJakcnoD8=9p6uFduSJALHzGs5n_A@mail.gmail.com>
References: <4bc4d258-1e12-4e1a-af9c-0019f099612f@googlegroups.com> <CAPTjJmoCwWk_n-rsxy9gJfJakcnoD8=9p6uFduSJALHzGs5n_A@mail.gmail.com>
Subject: Re: PEPs should be included with the documentation download
Date: Wed, 21 Aug 2013 13:55:44 -0400
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.90.1377107754.19984.python-list@python.org>
Lines: 20
NNTP-Posting-Host: 2001:888:2000:d::a6
X-Trace: 1377107754 news.xs4all.nl 15864 [2001:888:2000:d::a6]:56651
X-Complaints-To: abuse@xs4all.nl
Xref: csiph.com comp.lang.python:52778

On Wed, Aug 21, 2013, at 13:32, Chris Angelico wrote:
> On Wed, Aug 21, 2013 at 3:14 PM, Aseem Bansal <asmbansal2@gmail.com>
> wrote:
> > Currently the documentation download includes a lot of things but PEPs are not its part. I wanted to suggest that PEPs should be included in the download. They are very much relevant to Python.
> 
> The PEPs are kinda like the specs that Python is built from, rather
> than being end-user documentation; certainly most, if not all, are
> unnecessary to most use of Python. There's really no point downloading
> a whole pile of rejected PEPs as part of the crucial user-facing docs.
> 
> Also, how many people actually depend on the downloadable
> documentation, rather than simply reading things online?

If you've taken your laptop to somewhere there's no wi-fi, it's nice to
have offline help.

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.