From owner-freebsd-doc Thu Nov 30 14:15:23 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 9965237B402 for ; Thu, 30 Nov 2000 14:15:21 -0800 (PST) Received: (from jim@localhost) by envy.geekhouse.net (8.11.1/8.11.1) id eAUMFIw34029; Thu, 30 Nov 2000 14:15:18 -0800 (PST) (envelope-from jim) Date: Thu, 30 Nov 2000 14:15:17 -0800 From: Jim Mock To: Michael Lucas Cc: doc@FreeBSD.ORG Subject: Re: troubleshooting tree revisited Message-ID: <20001130141517.A33926@envy.geekhouse.net> Reply-To: jim@lust.geekhouse.net References: <20001130164838.A42727@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: <20001130164838.A42727@blackhelicopters.org>; from mwlucas@blackhelicopters.org on Thu, Nov 30, 2000 at 04:48:39PM -0500 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, 30 Nov 2000 at 16:48:39 -0500, Michael Lucas wrote: [snip..] > So, I have a few choices: > > 1) assume all readers are UNIX-literate, and abandon -questions to the > current cesspool of ex-Windows folks who don't know how to help > themselves. Makes the whole thing moot. Very maintainable, at least > from the -doc point of view. > > 2) maintain a separate information tree. Pros: can do whatever the > hell I want. Very poorly maintainable. > > 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? - 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