[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