Re: [Python-Dev] experimental: Misc/NEWS included in docs
On 09/30/2012 10:31 PM, Antoine Pitrou wrote: On Sun, 30 Sep 2012 12:14:37 -0700 Chris Jerdonek chris.jerdo...@gmail.com wrote: On Sun, Sep 30, 2012 at 6:17 AM, Georg Brandl g.bra...@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. Agreed. I think the titles are currently very confusing. The page you've just added should be called something like Changelog, to stress its more bare'n'technical natural compared to our official What's New pages. Also it would be extra nice if the What's new in Python X.Y section headers could be renamed to Python X.Y changelog, or similar. Please have a look again (it's renamed to .../changelog.html); Ezio and I tried to incorporate all the suggestions. Georg ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] experimental: Misc/NEWS included in docs
On Tue, Oct 2, 2012 at 8:46 PM, Georg Brandl g.bra...@gmx.net wrote: Please have a look again (it's renamed to .../changelog.html); Ezio and I tried to incorporate all the suggestions. Very nice. I tweaked the wording in the 3.3.1 section to be more explicit that it hasn't been released yet and people should look further down for the 3.3.0 changes. Cheers, Nick. -- Nick Coghlan | ncogh...@gmail.com | Brisbane, Australia ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
[Python-Dev] experimental: Misc/NEWS included in docs
Hi, 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. cheers, Georg ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] experimental: Misc/NEWS included in docs
Georg Brandl 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. Maybe you could supress those sections that become empty when a filter is applied. ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] experimental: Misc/NEWS included in docs
On Sun, Sep 30, 2012 at 6:17 AM, Georg Brandl g.bra...@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 ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
Re: [Python-Dev] experimental: Misc/NEWS included in docs
On Sun, Sep 30, 2012 at 3:14 PM, Chris Jerdonek chris.jerdo...@gmail.comwrote: On Sun, Sep 30, 2012 at 6:17 AM, Georg Brandl g.bra...@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. 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. ___ Python-Dev mailing list Python-Dev@python.org http://mail.python.org/mailman/listinfo/python-dev Unsubscribe: http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com
