From: Jeff A. <ja...@fa...> - 2017-06-10 09:18:56
|
Routine business, but this keeps confusing me, and I feel I may sometimes have inserted things in the wrong place. However, this is helpful: https://docs.python.org/devguide/committing.html?highlight=news#what-s-new-and-news-entries From the perspective of the reader, I think he needs to read NEWS as saying "In release such-and-such, the bugs fixed are: <list of bugs>". It follows that we insert bugs fixed at the top, and definitely above the name of the last release actually made at the time the bug fix went in. Possibly we are inserting under the title of the next release in prospect. If we follow the branch-naming strategy here: https://docs.python.org/devguide/devcycle.html#branches , then we often know what that release is to be called. It would be acceptable (better?) not to have a title at all above the first bug-fixed entry, meaning that it exists in the development tip (of the branch where you found the NEWS file). Accordingly, I'm moving the rc1 heading down to where it seems to belong, judging from a quick look at the commit log, and inserting rc2 and rc3 headings. Do put me right (& fix) if you're sure this is incorrect. -- Jeff Allen |
From: Jim B. <jim...@py...> - 2017-06-10 13:30:35
|
Agreed with the approach of not putting a heading above dev tip. And NEWS now looks good in terms of the specific cleanup you did. Thanks! On Sat, Jun 10, 2017 at 2:49 AM, Jeff Allen <ja...@fa...> wrote: > Routine business, but this keeps confusing me, and I feel I may sometimes > have inserted things in the wrong place. However, this is helpful: > https://docs.python.org/devguide/committing.html?highlight= > news#what-s-new-and-news-entries > > From the perspective of the reader, I think he needs to read NEWS as > saying "In release such-and-such, the bugs fixed are: <list of bugs>". > > It follows that we insert bugs fixed at the top, and definitely above the > name of the last release actually made at the time the bug fix went in. > Possibly we are inserting under the title of the next release in prospect. > If we follow the branch-naming strategy here: > https://docs.python.org/devguide/devcycle.html#branches , then we often > know what that release is to be called. It would be acceptable (better?) > not to have a title at all above the first bug-fixed entry, meaning that it > exists in the development tip (of the branch where you found the NEWS file). > > Accordingly, I'm moving the rc1 heading down to where it seems to belong, > judging from a quick look at the commit log, and inserting rc2 and rc3 > headings. Do put me right (& fix) if you're sure this is incorrect. > > -- > Jeff Allen > > > ------------------------------------------------------------ > ------------------ > Check out the vibrant tech community on one of the world's most > engaging tech sites, Slashdot.org! http://sdm.link/slashdot > _______________________________________________ > Jython-dev mailing list > Jyt...@li... > https://lists.sourceforge.net/lists/listinfo/jython-dev > |
From: <fwi...@gm...> - 2017-06-11 02:01:48
|
Big +1 On Sat, Jun 10, 2017 at 1:49 AM, Jeff Allen <ja...@fa...> wrote: > Routine business, but this keeps confusing me, and I feel I may sometimes > have inserted things in the wrong place. However, this is helpful: > https://docs.python.org/devguide/committing.html?highlight=news#what-s-new-and-news-entries > > From the perspective of the reader, I think he needs to read NEWS as saying > "In release such-and-such, the bugs fixed are: <list of bugs>". > > It follows that we insert bugs fixed at the top, and definitely above the > name of the last release actually made at the time the bug fix went in. > Possibly we are inserting under the title of the next release in prospect. > If we follow the branch-naming strategy here: > https://docs.python.org/devguide/devcycle.html#branches , then we often know > what that release is to be called. It would be acceptable (better?) not to > have a title at all above the first bug-fixed entry, meaning that it exists > in the development tip (of the branch where you found the NEWS file). > > Accordingly, I'm moving the rc1 heading down to where it seems to belong, > judging from a quick look at the commit log, and inserting rc2 and rc3 > headings. Do put me right (& fix) if you're sure this is incorrect. > > -- > Jeff Allen > > > ------------------------------------------------------------------------------ > Check out the vibrant tech community on one of the world's most > engaging tech sites, Slashdot.org! http://sdm.link/slashdot > _______________________________________________ > Jython-dev mailing list > Jyt...@li... > https://lists.sourceforge.net/lists/listinfo/jython-dev |