Date: Thu, 04 Jan 2001 11:29:11 -0800 (PST) From: John Baldwin <jhb@FreeBSD.org> To: Marius Bendiksen <mbendiks@eunet.no> Cc: arch@FreeBSD.org, Alfred Perlstein <bright@wintelcom.net>, David Xu <davidx@viasoft.com.cn>, Kris Kennaway <kris@FreeBSD.org>, "Bruce A. Mah" <bmah@FreeBSD.org> Subject: Re: Release notes (was Re: retiring kernfs) Message-ID: <XFMail.010104112911.jhb@FreeBSD.org> In-Reply-To: <Pine.BSF.4.05.10101041958460.88090-100000@login-1.eunet.no>
next in thread | previous in thread | raw e-mail | index | archive | help
On 04-Jan-01 Marius Bendiksen wrote: >> too much detail for our release notes. Basically, the problem is that >> the audience for our commit messages and the audience for "release >> notes" (as I perceive them anyways) are different. >> >> I've been doing a lot of the items for RELNOTES.TXT lately; it's >> sometimes hard figuring out what impact a given commit message is going >> to have on my-conception-of-the-average-user. Some other committers >> (I'm going to hold up gshapiro as a great example) do a wonderful job of >> documenting their commits in the release notes, which helps immensely. > > Why not mandate a line of the form > RELEASE NOTE: yyyymmdd[hhmm[ss]] account - note > and then have an automated script gather these up regularly? If that would work, then committers would be adding lines to RELNOTES.TXT directly on their own. > Marius -- John Baldwin <jhb@FreeBSD.org> -- http://www.FreeBSD.org/~jhb/ PGP Key: http://www.baldwin.cx/~john/pgpkey.asc "Power Users Use the Power to Serve!" - http://www.FreeBSD.org/ To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-arch" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?XFMail.010104112911.jhb>