cvs commit: src/release/doc/en_US.ISO8859-1/relnotes/common new.sgml

[Wilko Bulte]

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 at FreeBSD.org
|/|/ / / /(  (_)  Bulte