From owner-freebsd-arch Thu Jan 4 11: 0:53 2001 From owner-freebsd-arch@FreeBSD.ORG Thu Jan 4 11:00:51 2001 Return-Path: Delivered-To: freebsd-arch@freebsd.org Received: from mail-relay.eunet.no (mail-relay.eunet.no [193.71.71.242]) by hub.freebsd.org (Postfix) with ESMTP id EFDE537B400; Thu, 4 Jan 2001 11:00:49 -0800 (PST) Received: from login-1.eunet.no (login-1.eunet.no [193.75.110.2]) by mail-relay.eunet.no (8.9.3/8.9.3/GN) with ESMTP id UAA44981; Thu, 4 Jan 2001 20:00:39 +0100 (CET) (envelope-from mbendiks@eunet.no) Received: from localhost (mbendiks@localhost) by login-1.eunet.no (8.9.3/8.8.8) with ESMTP id UAA88107; Thu, 4 Jan 2001 20:00:39 +0100 (CET) (envelope-from mbendiks@eunet.no) X-Authentication-Warning: login-1.eunet.no: mbendiks owned process doing -bs Date: Thu, 4 Jan 2001 20:00:39 +0100 (CET) From: Marius Bendiksen To: "Bruce A. Mah" Cc: Kris Kennaway , David Xu , Alfred Perlstein , arch@FreeBSD.ORG Subject: Re: Release notes (was Re: retiring kernfs) In-Reply-To: <200012272151.eBRLpIc51777@bmah-freebsd-0.cisco.com> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: owner-freebsd-arch@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG > 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? Marius To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-arch" in the body of the message