From owner-freebsd-doc@FreeBSD.ORG Tue Aug 17 16:46:42 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id C218416A4CE; Tue, 17 Aug 2004 16:46:42 +0000 (GMT) Received: from b.mail.sonic.net (b.mail.sonic.net [64.142.19.5]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9B9E843D49; Tue, 17 Aug 2004 16:46:42 +0000 (GMT) (envelope-from bmah@freebsd.org) Received: from [192.168.0.27] (dns.packetdesign.com [65.192.41.10]) (authenticated bits=0) by b.mail.sonic.net (8.12.11/8.12.11) with ESMTP id i7HGkfj7004703 (version=TLSv1/SSLv3 cipher=EDH-RSA-DES-CBC3-SHA bits=168 verify=NO); Tue, 17 Aug 2004 09:46:42 -0700 From: "Bruce A. Mah" To: Tom Rhodes In-Reply-To: <20040817113649.0c60a790@localhost> References: <20040818.002504.07648782.hrs@eos.ocn.ne.jp> <20040817113649.0c60a790@localhost> Content-Type: multipart/signed; micalg=pgp-sha1; protocol="application/pgp-signature"; boundary="=-VhqpFzwpscgzwqQzeODp" Message-Id: <1092761125.864.22.camel@localhost.kitchenlab.org> Mime-Version: 1.0 X-Mailer: Ximian Evolution 1.4.6 Date: Tue, 17 Aug 2004 09:45:26 -0700 cc: Hiroki Sato cc: doc@freebsd.org Subject: Re: TODO items for 5.3R X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 17 Aug 2004 16:46:42 -0000 --=-VhqpFzwpscgzwqQzeODp Content-Type: text/plain Content-Transfer-Encoding: quoted-printable On Tue, 2004-08-17 at 08:36, Tom Rhodes wrote: > On Wed, 18 Aug 2004 00:25:04 +0900 (JST) > Hiroki Sato wrote: BTW, Hiroki, this is a great list. > > - Installation Notes > >=20 > > Some parts are outdated. doc/70485 has been committed, but more > > work is needed to reflect the realities. bmah@ pointed out > > that we should have "quick-start" installation guide for > > each platform instead of the current ones because they become > > too long and difficult to be maintained. >=20 > Bruce Mah sunk my battle ship! (For those who didn't have the dubious honor of growing up in the USA, this is a reference to a TV commercial for a "Battleship" board-game.) Tom, I remember this commercial, but I can't believe that you're old enough to have actually seen it yourself. :-) > Heh, to be honest, Bruce and I were talking about this a LONG > time ago and now that I have a sparc64 machine, I'm actually > going to get started on it. :) That's great...all I have is a pile of i386 boxes. To expand on this, I was thinking of something that was: 1. Short (two printed pages maximum). 2. Covering only the most common install cases (CD-ROM / DVD and, for platforms that support it, floppy). 3. Just enough to get a user to the sysinstall screen. The Handbook can take over from there. One nagging thing at the back of my head was that I'm not sure how first-time users would get to the Handbook.=20 Obviously it's easy if they have net access. 4. Mentioning platform-specific details (i.e. for i386, mention some BIOS settings such as boot order; for sparc64, list the commands one needs to type from the OFW console; for pc98, mention the 1.2MB floppies). I was thinking we should probably just write separate documents for each platform rather than try to do the MI thing that the installation notes do right now...there are just too many platform-specific details to handle during an install. Bruce. --=-VhqpFzwpscgzwqQzeODp Content-Type: application/pgp-signature; name=signature.asc Content-Description: This is a digitally signed message part -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.2.5 (FreeBSD) iD8DBQBBIjYl2MoxcVugUsMRAndhAJ4rRa34bprIUd8FgyBsZipHeRToHgCfYqjD JeY436ixUvEpn5IeRr7X8SY= =gM3z -----END PGP SIGNATURE----- --=-VhqpFzwpscgzwqQzeODp--