Date: Sun, 23 Jun 2019 18:09:31 -0400 From: Mark Johnston <markj@freebsd.org> To: Glen Barber <gjb@freebsd.org> Cc: Warner Losh <imp@bsdimp.com>, "freebsd-hackers@freebsd.org" <freebsd-hackers@freebsd.org>, FreeBSD Release Engineering Team <re@freebsd.org> Subject: Re: release notes file Message-ID: <20190623220931.GC50070@raichu> In-Reply-To: <20190623215729.GD41944@FreeBSD.org> References: <20190623191818.GA84365@raichu> <6B485E5C-9C8A-43C8-BD5A-528A74A61A23@FreeBSD.org> <79B7AEEE-7617-44D8-A16A-C8EC5F95455A@FreeBSD.org> <CANCZdfrvv9x3EyS=cgFQhKs6kNC9pnz5dnPziLbvYoyOT8UuZw@mail.gmail.com> <20190623201943.GB41944@FreeBSD.org> <20190623210959.GB50070@raichu> <20190623215729.GD41944@FreeBSD.org>
next in thread | previous in thread | raw e-mail | index | archive | help
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.
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20190623220931.GC50070>