Groups | Search | Server Info | Keyboard shortcuts | Login | Register [http] [https] [nntp] [nntps]

Groups > comp.lang.python > #30563

Re: [Python-Dev] experimental: Misc/NEWS included in docs

Path csiph.com!usenet.pasdenom.info!dedibox.gegeweb.org!gegeweb.eu!nntpfeed.proxad.net!proxad.net!feeder1-2.proxad.net!usenet-fr.net!nerim.net!novso.com!newsfeed.xs4all.nl!newsfeed5.news.xs4all.nl!xs4all!newsgate.cistron.nl!newsgate.news.xs4all.nl!post.news.xs4all.nl!not-for-mail
Return-Path <chris.jerdonek@gmail.com>
X-Original-To python-list@python.org
Delivered-To python-list@mail.python.org
X-Spam-Status OK 0.001
X-Spam-Evidence '*H*': 1.00; '*S*': 0.00; 'subject:: [': 0.03; '(at': 0.03; 'subject:Python': 0.05; 'nicely': 0.07; 'etc).': 0.09; 'meaningful': 0.09; 'sep': 0.09; 'suggestions:': 0.09; 'cc:addr :python-list': 0.10; 'extension': 0.13; 'useful,': 0.13; '"python': 0.16; 'bullet': 0.16; 'capability.': 0.16; 'differs': 0.16; 'modules,': 0.16; 'received:mail-wi0-f178.google.com': 0.16; 'subject:Dev': 0.16; 'subject:Misc': 0.16; 'subject:included': 0.16; 'url:py3k': 0.16; 'url:whatsnew': 0.16; 'wrote:': 0.17; 'library,': 0.17; 'subject:] ': 0.19; 'module': 0.19; 'changes': 0.20; 'tracker': 0.20; 'affected': 0.22; 'filtering': 0.22; 'cc:2**1': 0.24; 'least': 0.25; 'cc:addr:python.org': 0.25; 'header:In-Reply-To:1': 0.25; 'am,': 0.27; 'separate': 0.27; 'message-id:@mail.gmail.com': 0.27; "doesn't": 0.28; 'subject:/': 0.28; 'received:209.85.212': 0.28; 'informative': 0.29; 'python"': 0.29; 'though.': 0.29; 'related': 0.30; '(including': 0.30; 'e.g.': 0.30; 'url:python': 0.32; 'could': 0.32; 'likely': 0.33; 'another': 0.33; 'received:google.com': 0.34; 'done': 0.34; 'list': 0.35; 'received:209.85': 0.35; 'there': 0.35; 'but': 0.36; 'url:org': 0.36; 'cc:no real name:2**1': 0.36; 'guidance': 0.36; 'two': 0.37; 'received:209': 0.37; 'subject:: ': 0.38; 'some': 0.38; 'url:docs': 0.38; 'page': 0.38; 'where': 0.40; 'skip:" 10': 0.40; 'subject:-': 0.40; 'header:Received:5': 0.40; 'think': 0.40; 'link': 0.60; 'time,': 0.62; '30,': 0.62; 'more': 0.63; 'charset:windows-1252': 0.65; 'detail.': 0.65; 'matter.': 0.65; 'useful.': 0.65; 'rendering': 0.71; 'descriptive': 0.84; 'distinctive': 0.84; 'lastly,': 0.84
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 :cc:content-type:content-transfer-encoding; bh=CkHG9tW3D6V389GqB+rfl/+jM9axyraTYYqHeuYwsqw=; b=uSAAieUv8GD6UHuo3ed4mvRTuz0BEbOIZcs0NUiBmj3RY2Gg47YVGeEtvWlmBCan3f Oo/Jm1uW/lyCCppDAEGv1pGOq5PlHDRKXcGyrNrihcPxHiq4HgXvYEO4qP14vzZ9qruz UsSHjsF7VDVi+qjoR7Wi/24fpks3eiQMxOUJUEm+wGJfodq5NDLtrigVxXfVaA/RQ5yx xXS1hP4SXn9wXNMZMpOWwKFawWA6i2rnoRsEvPMlEkOkhLW1uFBWdl97UER9U0KoIJAj RQLpBMu81N1lcN0769RnvW7uIinlKf3F03Yoo5e9V+JUzq+5FIKvH3cOfEspq32Wcnz4 277Q==
MIME-Version 1.0
In-Reply-To <k49gpe$2dt$1@ger.gmane.org>
References <k49gpe$2dt$1@ger.gmane.org>
Date Sun, 30 Sep 2012 12:14:37 -0700
Subject Re: [Python-Dev] experimental: Misc/NEWS included in docs
From Chris Jerdonek <chris.jerdonek@gmail.com>
To Georg Brandl <g.brandl@gmx.net>
Content-Type text/plain; charset=windows-1252
Content-Transfer-Encoding quoted-printable
Cc python-list@python.org, python-dev@python.org
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.1680.1349032485.27098.python-list@python.org> (permalink)
Lines 33
NNTP-Posting-Host 2001:888:2000:d::a6
X-Trace 1349032485 news.xs4all.nl 6857 [2001:888:2000:d::a6]:39023
X-Complaints-To abuse@xs4all.nl
Xref csiph.com comp.lang.python:30563

Show key headers only | View raw

On Sun, Sep 30, 2012 at 6:17 AM, Georg Brandl <g.brandl@gmx.net> wrote:
> at http://docs.python.org/3.3/whatsnew/news.html, there is now
> a rendering of Misc/NEWS with tracker links and a crude filtering
> capability.  I thought that this will complement the "whatsnew"
> documents nicely for people looking for more detail.
>
> Please let me know if it's useful, or what could be done to make
> it *more* useful.

Good idea.  Some suggestions:

* A note at the top explaining what this page is and how it differs
from the other What's New page (including perhaps a link to the other
What's New page).  It might also be good if the two had more
distinctive titles.  They are currently "What’s New in Python" and
"Python News."

* It would be good if the section links could somehow be
"perma-links."  They will currently vary over time, e.g.
  http://docs.python.org/py3k/whatsnew/news.html#id3

* Lastly, I think skimming this list would be more informative to me
at least if each bullet began with the name of the affected module or
area (at least in the case where just one module is affected).  The
issue number is less meaningful as a descriptive header.  Changing
this would likely require changes in how we prepare Misc/NEWS though.

On a separate but related note, I never know where to put the various
subsections in relation to one another in Misc/NEWS (Core and
Builtins, Library, Extension Modules, etc).  It would be good if there
was guidance on that -- even if to say it completely doesn't matter.

--Chris

Back to comp.lang.python | Previous | Next | Find similar | Unroll thread

Thread

Re: [Python-Dev] experimental: Misc/NEWS included in docs Chris Jerdonek <chris.jerdonek@gmail.com> - 2012-09-30 12:14 -0700

csiph-web