Re: [Xen-devel] [PATCH] Introduce CHANGELOG.md

["Durrant, Paul" <pdurrant@xxxxxxxxxxxx>]

> -----Original Message-----
> From: Jan Beulich <jbeulich@xxxxxxxx>
> Sent: 10 January 2020 09:52
> To: Durrant, Paul <pdurrant@xxxxxxxxxxxx>
> Cc: xen-devel@xxxxxxxxxxxxxxxxxxxx; Andrew Cooper
> <andrew.cooper3@xxxxxxxxxx>; George Dunlap <George.Dunlap@xxxxxxxxxxxxx>;
> Ian Jackson <ian.jackson@xxxxxxxxxxxxx>; Julien Grall <julien@xxxxxxx>;
> Konrad Rzeszutek Wilk <konrad.wilk@xxxxxxxxxx>; Stefano Stabellini
> <sstabellini@xxxxxxxxxx>; Wei Liu <wl@xxxxxxx>; Lars Kurth
> <lars.kurth@xxxxxxxxxx>
> Subject: Re: [PATCH] Introduce CHANGELOG.md
> 
> On 10.01.2020 10:12, Paul Durrant wrote:
> > --- /dev/null
> > +++ b/CHANGELOG.md
> > @@ -0,0 +1,14 @@
> > +# Changelog
> > +
> > +All notable changes to Xen will be documented in this file.
> 
> How do we qualify what's "notable" and what's not? IOW I wonder
> whether "All" should be dropped, or be replaced by "Some".
> 

Agreed that it's debatable. Perhaps just drop the 'All' and say:

'Notable changes to Xen will be documented in this file.'

?

Patch authors ought to update the file if they consider their contribution(s) 
notable but I'd also hope that maintainers will express an opinion as to 
whether something should be included/not included. It's not going to be 
fool-proof but I think it will be better than nothing.

  Paul

> Jan
_______________________________________________
Xen-devel mailing list
Xen-devel@xxxxxxxxxxxxxxxxxxxx
https://lists.xenproject.org/mailman/listinfo/xen-devel