From owner-freebsd-doc Thu Nov 30 14:56: 8 2000 Delivered-To: freebsd-doc@freebsd.org Received: from envy.geekhouse.net (envy.geekhouse.net [64.81.6.50]) by hub.freebsd.org (Postfix) with ESMTP id 8BB4637B402 for ; Thu, 30 Nov 2000 14:56:06 -0800 (PST) Received: (from jim@localhost) by envy.geekhouse.net (8.11.1/8.11.1) id eAUMu3H36766; Thu, 30 Nov 2000 14:56:03 -0800 (PST) (envelope-from jim) Date: Thu, 30 Nov 2000 14:56:01 -0800 From: Jim Mock To: Michael Lucas Cc: doc@FreeBSD.ORG Subject: Re: troubleshooting tree revisited Message-ID: <20001130145559.B34244@envy.geekhouse.net> Reply-To: jim@lust.geekhouse.net References: <20001130164838.A42727@blackhelicopters.org> <20001130141517.A33926@envy.geekhouse.net> <20001130174959.A42968@blackhelicopters.org> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.3.12i In-Reply-To: <20001130174959.A42968@blackhelicopters.org>; from mwlucas@blackhelicopters.org on Thu, Nov 30, 2000 at 05:49:59PM -0500 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, 30 Nov 2000 at 17:49:59 -0500, Michael Lucas wrote: > On Thu, Nov 30, 2000 at 02:15:17PM -0800, Jim Mock wrote: > > > 3) "dumb down" the Handbook and FAQ. Very maintainable. Downside: I > > > would be hung by competent FreeBSD admins who just want to RTFM and > > > get a quick answers. YMMV, but I think the downside is unacceptable, > > > so I'm not going to do the work. > > > > This isn't a totally bad thing. We can have a "dumbed down" book and > > turn it into the new user's handbook instead of what I have at > > http://soupnazi.org/FreeBSD/docs/ since we wanted such a book > > anyway. It would be something along the lines of the developers > > handbook and the porter's handbook, only for new users. Thoughts? > > Then we get into maintaining information in multiple places. :( > Unless "conditional compilation" is an option... have two books, but > one SGML file... No.. I mean it'd be it's own book. Maintained in one place. Not part of the handbook, but it's own separate animal like the porter's handbook (http://www.FreeBSD.org/porters-handbook/). - jim -- jim mock work: jim@osd.bsdi.com | jim@FreeBSD.org http://soupnazi.org/ BSDi Open Source Div | http://bsdi.com To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message