From owner-freebsd-doc Sat Apr 6 17: 2:10 2002 Delivered-To: freebsd-doc@freebsd.org Received: from pittgoth.com (14.zlnp1.xdsl.nauticom.net [209.195.149.111]) by hub.freebsd.org (Postfix) with ESMTP id EDAF537B420; Sat, 6 Apr 2002 17:01:45 -0800 (PST) Received: from localhost (c6.depaul-inst.pittsburgh.pa.us [192.168.1.6]) by pittgoth.com (8.11.6/8.11.6) with SMTP id g3711e618255; Sat, 6 Apr 2002 20:01:40 -0500 (EST) (envelope-from darklogik@pittgoth.com) Date: Sat, 6 Apr 2002 20:09:38 -0500 From: Tom Rhodes To: murray@stokely.org Cc: keramida@FreeBSD.ORG, freebsd-doc@FreeBSD.ORG Subject: Re: Splitting the Handbook? (was: [a couple of new doc PRs]) Message-Id: <20020406200938.23dd2ef4.darklogik@pittgoth.com> In-Reply-To: <20020407001148.GA8008@freebsdmall.com> References: <20020404062954.6607E2E827@mail.freebsdmall.com> <20020406221709.GA1181@hades.hell.gr> <20020406231126.GP5732@freebsdmall.com> <20020406190204.21cad8a8.darklogik@pittgoth.com> <20020407001148.GA8008@freebsdmall.com> X-Mailer: Sylpheed version 0.7.4 (GTK+ 1.2.10; i386-portbld-freebsd4.5) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org On Sat, 6 Apr 2002 16:11:48 -0800 murray@stokely.org wrote: > On Sat, Apr 06, 2002 at 07:02:04PM -0500, Tom Rhodes wrote: > > And so on, each book should contain: > > > > Ports and packages installation > > System Installation and Configuration > > Rebuilding your Kernel > > Staying up to date *cutting edge* (some people may want this) > > That is over 130 pages of content. I do NOT think all of that > material should be repeated in each book. That material should just > be in the "Getting Started" guide, or other appropriately named > guides. I figured, and yes I know ``figured'' is not usually the best way to go, but anyway I figured it would probly be helpful for people. But this would need more discussing. What I mainly am getting at, is that it might not be the best idea for that information to only be in one printed book, as it could pertain to new users and competant sysadmins at the same time... Thoughts? > > > And the back of these books (printed versions) and online listings > > should contain the information that is presented within, so that > > people know exactly what they are getting... > > Each book needs to have a preface, table of contents, and > introduction, to describe the material contained therein. You are correct, this information should be in the front, but I feel strongly that some information should be on the back. I know that i'm talking of printed versions, and not online versions, and most people will agree that the back description is of importance also. I usually read that part ;) > > - Murray > -- Tom (Darklogik) Rhodes www.FreeBSD.org -The Power To Serve www.Pittgoth.com -Pittgoth Discussion Portal trhodes@{Pittgoth.com, FreeBSD.org} PGP key by www: http://www.pittgoth.com/~darklogik/darklogik.key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message