[RFC] NEWS subheadings: Changes -> Compatibility Breaks

Martin Pool mbp at sourcefrog.net
Tue Jan 13 03:02:57 GMT 2009

2009/1/13 Ian Clatworthy <ian.clatworthy at canonical.com>:
> John Arbash Meinel wrote:
>> Ian Clatworthy wrote:
>>> I'd like to propose that the section in NEWS called CHANGES
>>> be renamed to COMPATIBILITY BREAKS and be moved to just before
>>> API BREAKS. I think that would clear up the confusion about
>>> what ought to go in that section (vs FEATURES vs IMPROVEMENTS).
>> I've seen things in CHANGES where don't actually fit under that. It
>> would certainly be nice if we had clear ideas as to what goes where. I
>> suppose some of them might fit better in IMPROVEMENTS ?
> Martin,
> As 1.12 is just getting under way, I think now is a good time
> to introduce this subheading edit. Unless there are objections,
> can you/we please do so when adding the empty sections to NEWS for
> 1.12 development?

The new name is fine with me.

I think it should still be at the top of the file, because it's
something that every user needs to see whereas API changes only affect
a few people.

I'll add the template and make that change now.

Martin <http://launchpad.net/~mbp/>

More information about the bazaar mailing list