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 cf.natali@gmail.com wrote:
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.
On Sun, 27 Jan 2013 10:56:51 +0100 Charles-François Natali cf.natali@gmail.com 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 :-)).
Regards
Antoine.
On Sun, Jan 27, 2013 at 6:02 AM, Antoine Pitrou solipsis@pitrou.net wrote:
On Sun, 27 Jan 2013 10:56:51 +0100 Charles-François Natali cf.natali@gmail.com 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