release notes file

[Mark Johnston]

On Sun, Jun 23, 2019 at 09:57:29PM +0000, Glen Barber wrote:
> On Sun, Jun 23, 2019 at 05:09:59PM -0400, Mark Johnston wrote:
> > Regarding whether RELNOTES entries should be removed, I would prefer to
> > keep them at least until head is branched.  They would serve as useful
> > documentation to users, and if there are multiple people compiling
> > release notes they can synchronize in other ways.  At least, I would
> > wait for it to become a problem before trying to solve it by removing
> > entries from RELNOTES.
> > 
> 
> To your latter point, removing the RELNOTES entries, this is what I sort
> of had in mind:
> 
>  head -> stable/X -> releng/X.Y:
>   head/RELNOTES gets truncated after stable/X is created;
>   stable/X gets truncated after releng/X.Y is created
> 
> For point releases, the workflow is similar as it just excludes head:
>  stable/X -> releng/X.Y:
>   stable/X gets truncated after releng/X.Y is created
> 
> In other words, there would be no arbitrarily-long file, but there
> would potentially be some overlap for a major release where a dot-zero
> release has last-minute new stuff that should be in release notes; it
> would grow and shrink as development happens.
> 
> Or, this is how I see it being most beneficial to RE when it comes to
> writing release notes, at least.

This is what I had pictured as well.