<br><br><div class="gmail_quote">On Sun, Sep 30, 2012 at 3:14 PM, Chris Jerdonek <span dir="ltr"><<a href="mailto:chris.jerdonek@gmail.com" target="_blank">chris.jerdonek@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">

<div class="im">On Sun, Sep 30, 2012 at 6:17 AM, Georg Brandl <<a href="mailto:g.brandl@gmx.net">g.brandl@gmx.net</a>> wrote:<br>
> at <a href="http://docs.python.org/3.3/whatsnew/news.html" target="_blank">http://docs.python.org/3.3/whatsnew/news.html</a>, there is now<br>
> a rendering of Misc/NEWS with tracker links and a crude filtering<br>
> capability.  I thought that this will complement the "whatsnew"<br>
> documents nicely for people looking for more detail.<br>
><br>
> Please let me know if it's useful, or what could be done to make<br>
> it *more* useful.<br>
<br>
</div>Good idea.  Some suggestions:<br>
<br>
* A note at the top explaining what this page is and how it differs<br>
from the other What's New page (including perhaps a link to the other<br>
What's New page).  It might also be good if the two had more<br>
distinctive titles.  They are currently "What’s New in Python" and<br>
"Python News."<br>
<br>
* It would be good if the section links could somehow be<br>
"perma-links."  They will currently vary over time, e.g.<br>
  <a href="http://docs.python.org/py3k/whatsnew/news.html#id3" target="_blank">http://docs.python.org/py3k/whatsnew/news.html#id3</a><br>
<br>
* Lastly, I think skimming this list would be more informative to me<br>
at least if each bullet began with the name of the affected module or<br>
area (at least in the case where just one module is affected).  The<br>
issue number is less meaningful as a descriptive header.  Changing<br>
this would likely require changes in how we prepare Misc/NEWS though.<br>
<br>
On a separate but related note, I never know where to put the various<br>
subsections in relation to one another in Misc/NEWS (Core and<br>
Builtins, Library, Extension Modules, etc).  It would be good if there<br>
was guidance on that -- even if to say it completely doesn't matter.<br></blockquote><div><br></div><div>It doesn't matter. When I've done it I have either copied the empty sections previously or not even bothered with the empty sections and just let others add as necessary. </div>

</div>