From owner-cvs-all@FreeBSD.ORG Tue Mar 25 13:26:16 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 8779537B401; Tue, 25 Mar 2003 13:26:16 -0800 (PST) Received: from freebie.xs4all.nl (freebie.xs4all.nl [213.84.32.253]) by mx1.FreeBSD.org (Postfix) with ESMTP id 7E14A43F85; Tue, 25 Mar 2003 13:26:14 -0800 (PST) (envelope-from wkb@freebie.xs4all.nl) Received: from freebie.xs4all.nl (localhost [127.0.0.1]) by freebie.xs4all.nl (8.12.8/8.12.8) with ESMTP id h2PLQD4c002844; Tue, 25 Mar 2003 22:26:13 +0100 (CET) (envelope-from wkb@freebie.xs4all.nl) Received: (from wkb@localhost) by freebie.xs4all.nl (8.12.8/8.12.8/Submit) id h2PLQDkF002843; Tue, 25 Mar 2003 22:26:13 +0100 (CET) Date: Tue, 25 Mar 2003 22:26:13 +0100 From: Wilko Bulte To: "Bruce A. Mah" Message-ID: <20030325212613.GA2823@freebie.xs4all.nl> References: <200303212246.h2LMkXQg017386@repoman.freebsd.org> <20030322001218.GA57299@intruder.bmah.org> <20030324180300.GA21439@freebie.xs4all.nl> <20030325172859.GD988@intruder.bmah.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <20030325172859.GD988@intruder.bmah.org> User-Agent: Mutt/1.4i X-OS: FreeBSD 4.8-RC X-PGP: finger wilko@freebsd.org X-Spam-Status: No, hits=-31.7 required=5.0 tests=AWL,EMAIL_ATTRIBUTION,IN_REP_TO,QUOTED_EMAIL_TEXT, REFERENCES,REPLY_WITH_QUOTES,USER_AGENT_MUTT autolearn=ham version=2.50 X-Spam-Level: X-Spam-Checker-Version: SpamAssassin 2.50 (1.173-2003-02-20-exp) cc: cvs-src@FreeBSD.ORG cc: src-committers@FreeBSD.ORG cc: cvs-all@FreeBSD.ORG cc: Wilko Bulte 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 21:26:18 -0000 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