From owner-freebsd-doc@FreeBSD.ORG Tue Aug 17 17:07:49 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 789F516A4CE; Tue, 17 Aug 2004 17:07:49 +0000 (GMT) Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by mx1.FreeBSD.org (Postfix) with ESMTP id 08E3B43D55; Tue, 17 Aug 2004 17:07:49 +0000 (GMT) (envelope-from trhodes@FreeBSD.org) Received: from localhost (acs-24-154-239-170.zoominternet.net [24.154.239.170]) (authenticated bits=0) by pittgoth.com (8.12.10/8.12.10) with ESMTP id i7HH7k0l075489 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-SHA bits=256 verify=NOT); Tue, 17 Aug 2004 13:07:48 -0400 (EDT) (envelope-from trhodes@FreeBSD.org) Date: Tue, 17 Aug 2004 13:08:22 -0400 From: Tom Rhodes To: "Bruce A. Mah" Message-Id: <20040817130822.142f72e5@localhost> In-Reply-To: <1092761125.864.22.camel@localhost.kitchenlab.org> References: <20040818.002504.07648782.hrs@eos.ocn.ne.jp> <20040817113649.0c60a790@localhost> <1092761125.864.22.camel@localhost.kitchenlab.org> X-Mailer: Sylpheed-Claws 0.9.12 (GTK+ 1.2.10; i386-portbld-freebsd5.2) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: Tom Rhodes 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 17:07:49 -0000 On Tue, 17 Aug 2004 09:45:26 -0700 "Bruce A. Mah" wrote: > 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 > > > > > > 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. > > > > 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. :-) Oh yea, I'm hella old y0, like 23 going on 24. :( But I did grow up in the 80s, I swear the commercial came out in like 84-86. Somewhere in there, and when they came out with electronic talking battleship well, I had one of those but not the original. Perhaps I only seen one of the later commercials for say, electronic talking battle ship or whatever. But this isn't really important, nor the fact that I remember Warrant's "Cherry Pie" video on MTV. > > > 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). Yes, there isn't much difference between the install proceedures. Only difference may be how you boot. For instance, on Sun machines with OpenBoot you have several options: Ok boot cdrom Ok boot floppy Ok boot net ... > > 2. Covering only the most common install cases (CD-ROM / DVD and, for > platforms that support it, floppy). As above. :) > > 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. > Obviously it's easy if they have net access. This is something that has been on my mind for ages and I really have no clue how to work around it. :( > > 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. That shouldn't be difficult. I'm sure I even have our old discussions in my inbox somewhere. I *think* we discussed something like: Adding a boot section for each platform, or Adding a boot section part which got the user to sysinstall and: append the rest of the install chapter to it. There was some more discussion but I'm too busy to dig it up and will do so later on this evening. :) -- Tom Rhodes