From owner-freebsd-doc@FreeBSD.ORG Sat Jan 6 23:24:15 2007 Return-Path: X-Original-To: doc@freebsd.org Delivered-To: freebsd-doc@FreeBSD.ORG Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 3568016A412; Sat, 6 Jan 2007 23:24:15 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from pne-smtpout1-sn2.hy.skanova.net (pne-smtpout1-sn2.hy.skanova.net [81.228.8.83]) by mx1.freebsd.org (Postfix) with ESMTP id F230F13C441; Sat, 6 Jan 2007 23:24:14 +0000 (UTC) (envelope-from niclas.zeising@gmail.com) Received: from [90.224.61.244] (90.224.61.244) by pne-smtpout1-sn2.hy.skanova.net (7.2.075) id 453F8F4200EDCCDE; Sat, 6 Jan 2007 23:15:04 +0100 Message-ID: <45A01F66.7050904@gmail.com> Date: Sat, 06 Jan 2007 23:15:02 +0100 From: Niclas Zeising User-Agent: Thunderbird 1.5.0.9 (Windows/20061207) MIME-Version: 1.0 To: "Bruce A. Mah" References: <459FB98E.7060209@gmail.com> <45A00F38.10803@freebsd.org> In-Reply-To: <45A00F38.10803@freebsd.org> Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit Cc: doc@freebsd.org Subject: Re: Changes and Updates to Installation chapter X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 06 Jan 2007 23:24:15 -0000 Bruce A. Mah wrote: > If memory serves me right, Niclas Zeising wrote: >> This is a list of changes that I think are needed in the Installation >> Chapter of the Handbook. It is not a patch to the documentation or >> anything, I want to discuss the changes before continuing working with >> doing the actual changes. > > On a related note: > > There's an article called "Installation Notes" or some such thing in the > release documentation. It is probably older than the installation > chapter in the handbook, and was never anywhere near as well-maintained. > > Two or three years ago, I started working on converting this to a kind > of "Quickstart Guide", which would basically cover downloading and > creating install media, and the initial bootstrap steps up to the point > of the main install menu. It was never finished, although I have some > hopes of seeing this work used somehow. (I have neither the time nor > knowledge required to finish this properly, alas.) > > Here's a PDF of what it looked like: > > http://people.freebsd.org/~bmah/doc/quickstart.pdf > > If there's some good, solid interest in finishing this, I can figure out > a reasonable way to put the source files into FreeBSD Perforce or > something like that for some other doc types to hack on. > > I mention this mostly in the hope that there'd be a way for a Quickstart > Guide and the Installation Chapter to mesh somehow. Somebody mentioned > to me once that maybe the quickstart guide could be a subset of the > installation chapter, which is also an idea worth pursuing. I think it's a great idea with some sort of quick start. I think it can live together with the installation chapter and be a subset, just as you mentioned. It can be a reference for the impatient who just want to set up a system as quick as possible or for the experienced user who only need some quick notes on how it's done in FreeBSD. In that document you can point to where in the handbook you can find more in-depth information about the tasks. Maybe it can live in the iso-file/on the cd as well as on the webpage, so you get the quick guide together with the software, just as with the "Installation Notes". We just have to make sure to update the docs in both places. Regards! //Niclas