cvs commit: src/release/doc/en_US.ISO8859-1/relnotes/common
wkb at freebie.xs4all.nl
Tue Mar 25 21:26:18 PST 2003
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
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 at FreeBSD.org
|/|/ / / /( (_) Bulte
More information about the cvs-src