From owner-cvs-all@FreeBSD.ORG Tue Mar 25 09:29:02 2003 Return-Path: Delivered-To: cvs-all@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 389D237B401; Tue, 25 Mar 2003 09:29:02 -0800 (PST) Received: from rwcrmhc53.attbi.com (rwcrmhc53.attbi.com [204.127.198.39]) by mx1.FreeBSD.org (Postfix) with ESMTP id BB16143F85; Tue, 25 Mar 2003 09:29:00 -0800 (PST) (envelope-from bmah@employees.org) Received: from bmah.dyndns.org (12-240-204-110.client.attbi.com[12.240.204.110]) by rwcrmhc53.attbi.com (rwcrmhc53) with ESMTP id <20030325172900053005k1gfe>; Tue, 25 Mar 2003 17:29:00 +0000 Received: from intruder.bmah.org (localhost [127.0.0.1]) by bmah.dyndns.org (8.12.8/8.12.8) with ESMTP id h2PHSxv5001253; Tue, 25 Mar 2003 09:28:59 -0800 (PST) (envelope-from bmah@intruder.bmah.org) Received: (from bmah@localhost) by intruder.bmah.org (8.12.8/8.12.8/Submit) id h2PHSxo7001252; Tue, 25 Mar 2003 09:28:59 -0800 (PST) Date: Tue, 25 Mar 2003 09:28:59 -0800 From: "Bruce A. Mah" To: Wilko Bulte Message-ID: <20030325172859.GD988@intruder.bmah.org> References: <200303212246.h2LMkXQg017386@repoman.freebsd.org> <20030322001218.GA57299@intruder.bmah.org> <20030324180300.GA21439@freebie.xs4all.nl> Mime-Version: 1.0 Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="2iBwrppp/7QCDedR" Content-Disposition: inline In-Reply-To: <20030324180300.GA21439@freebie.xs4all.nl> User-Agent: Mutt/1.4.1i X-Image-Url: http://www.employees.org/~bmah/Images/bmah-cisco-small.gif X-url: http://www.employees.org/~bmah/ X-Spam-Status: No, hits=-22.6 required=5.0 tests=AWL,EMAIL_ATTRIBUTION,IN_REP_TO,PGP_SIGNATURE_2, QUOTED_EMAIL_TEXT,QUOTE_TWICE_1,RCVD_IN_UNCONFIRMED_DSBL, REFERENCES,REPLY_WITH_QUOTES,USER_AGENT_MUTT version=2.50 X-Spam-Level: X-Spam-Checker-Version: SpamAssassin 2.50 (1.173-2003-02-20-exp) cc: "Bruce A. Mah" cc: src-committers@FreeBSD.ORG cc: cvs-all@FreeBSD.ORG cc: Wilko Bulte cc: cvs-src@FreeBSD.ORG Subject: Re: cvs commit: src/release/doc/en_US.ISO8859-1/relnotes/common new.sgml X-BeenThere: cvs-all@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: CVS commit messages for the entire tree List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 25 Mar 2003 17:29:05 -0000 --2iBwrppp/7QCDedR Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Content-Transfer-Encoding: quoted-printable If memory serves me right, Wilko Bulte wrote: > On Fri, Mar 21, 2003 at 04:12:18PM -0800, Bruce A. Mah wrote: > > If/when somebody stumbles over this problem in future versions of > > FreeBSD, they're probably not going to come back to the 4.8 release > > notes to find it. I'll leave it where it is, but after RELENG_4 is > > open again, could you please insert this text into the hardware notes, > > so it'll be there for future reference? Thanks. >=20 > You mean release/doc/en_US.ISO8859-1/hardware/alpha/proc-alpha.sgml? Yeah, that's what I meant. > It is in there already, but I am sort-of worried (how many folks have > Turbolasers at home? ;-) that people would not find it there. Heh. :-) What I am concerned about is that I don't want to see the release notes turn into a dumping ground for "various things that people should know". (Note that I am not accusing you or anybody else of doing this...I'm just expressing a part of my criteria for figuring out what kinds of material to add.) More specifically: 1. I truncate the release notes after every release. If your item needs to be seen over multiple releases, then the release notes document is probably not permanent enough of a place to put it. Someplace such as the hardware notes, Handbook, or FAQ might be better. 2. The release notes describe changes from one release to the next. It's true that a lot of people read it when upgrading, but that doesn't excuse them from looking at other sources of information (such as UPDATING). This is not a huge problem, and I don't want to stop you (or anybody else) from committing release notes changes. If there's sufficient time, I might ask for items to be redirected to places I think are more appropriate. But in any case I'm glad for the help that you and others have given to the release documentation. Thanks! Bruce. --2iBwrppp/7QCDedR Content-Type: application/pgp-signature Content-Disposition: inline -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.1 (FreeBSD) iD8DBQE+gJHa2MoxcVugUsMRAh84AKDwSeoZyg1W61C4MxfifpMj4tfRGQCfeBcg BSHb/1ZtJDe7P6GXuBs9FR8= =1aTZ -----END PGP SIGNATURE----- --2iBwrppp/7QCDedR--