Date: Tue, 25 Mar 2003 22:26:13 +0100 From: Wilko Bulte <wkb@freebie.xs4all.nl> To: "Bruce A. Mah" <bmah@FreeBSD.ORG> Cc: Wilko Bulte <wilko@FreeBSD.ORG> Subject: Re: cvs commit: src/release/doc/en_US.ISO8859-1/relnotes/common new.sgml Message-ID: <20030325212613.GA2823@freebie.xs4all.nl> In-Reply-To: <20030325172859.GD988@intruder.bmah.org> References: <200303212246.h2LMkXQg017386@repoman.freebsd.org> <20030322001218.GA57299@intruder.bmah.org> <20030324180300.GA21439@freebie.xs4all.nl> <20030325172859.GD988@intruder.bmah.org>
next in thread | previous in thread | raw e-mail | index | archive | help
On Tue, Mar 25, 2003 at 09:28:59AM -0800, Bruce A. Mah wrote: > 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. > > > 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.) No problem, I have been puzzled myself on what the most appropriate place is to put installation instructions. > 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. The hardware notes apparantly are not read too well judging from the questions on the lists. > 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). I personally consider UPDATING more geared towards people updating from src, not for people installing from a Release media like CDROM. What probably is lacking is a more to the point installation manual which allows platform/machine specific instructions. Particularly for the non-x86 ports this is important. -- | / o / /_ _ wilko@FreeBSD.org |/|/ / / /( (_) Bulte
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20030325212613.GA2823>