usefulness of "extension modules" section in Misc/NEWS
Hi, What's exactly the guideline for choosing between the "Library" and "Extension modules" section when updating Misc/NEWS? Is it just the fact that the modified files live under Lib/ or Modules/? I've frequently made a mistake when updating Misc/NEWS, and when looking at it, I'm not the only one. Is there really a good reason for having distinct sections? If the intended audience for this file are end users, ISTM that the only things that matters is that it's a library change, the fact that the modification impacted Python/C code isn't really relevant. Also, for example if you're rewriting a library from Python to C (or vice versa), should it appear under both sections? FWIW, the What's new documents don't have such a distinction. Cheers, cf
On Sun, Jan 27, 2013 at 7:56 PM, Charles-François Natali
If the intended audience for this file are end users, ISTM that the only things that matters is that it's a library change, the fact that the modification impacted Python/C code isn't really relevant.
I have no objection to merging them. A separate section for "C API" may still make sense, though. Cheers, Nick. -- Nick Coghlan | ncoghlan@gmail.com | Brisbane, Australia
On Sun, 27 Jan 2013 10:56:51 +0100
Charles-François Natali
Hi,
What's exactly the guideline for choosing between the "Library" and "Extension modules" section when updating Misc/NEWS? Is it just the fact that the modified files live under Lib/ or Modules/?
I've frequently made a mistake when updating Misc/NEWS, and when looking at it, I'm not the only one.
Is there really a good reason for having distinct sections?
If the intended audience for this file are end users, ISTM that the only things that matters is that it's a library change, the fact that the modification impacted Python/C code isn't really relevant.
Agreed. I think "we" should merge them (for some value of a motivated we :-)). Regards Antoine.
On Sun, Jan 27, 2013 at 6:02 AM, Antoine Pitrou
On Sun, 27 Jan 2013 10:56:51 +0100 Charles-François Natali
wrote: Hi,
What's exactly the guideline for choosing between the "Library" and "Extension modules" section when updating Misc/NEWS? Is it just the fact that the modified files live under Lib/ or Modules/?
I've frequently made a mistake when updating Misc/NEWS, and when looking at it, I'm not the only one.
Is there really a good reason for having distinct sections?
If the intended audience for this file are end users, ISTM that the only things that matters is that it's a library change, the fact that the modification impacted Python/C code isn't really relevant.
Agreed. I think "we" should merge them (for some value of a motivated we :-)).
"We" is "me" and it was a 2 line delete in 1fabff717ef4
participants (4)
-
Antoine Pitrou
-
Brett Cannon
-
Charles-François Natali
-
Nick Coghlan