From owner-freebsd-doc@FreeBSD.ORG Thu Oct 6 17:49:20 2005 Return-Path: X-Original-To: freebsd-doc@freebsd.org 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 416C316A41F for ; Thu, 6 Oct 2005 17:49:20 +0000 (GMT) (envelope-from lgusenet@be-well.ilk.org) Received: from mail21.sea5.speakeasy.net (mail21.sea5.speakeasy.net [69.17.117.23]) by mx1.FreeBSD.org (Postfix) with ESMTP id E9BA143D46 for ; Thu, 6 Oct 2005 17:49:19 +0000 (GMT) (envelope-from lgusenet@be-well.ilk.org) Received: (qmail 13244 invoked from network); 6 Oct 2005 17:49:19 -0000 Received: from dsl092-078-145.bos1.dsl.speakeasy.net (HELO be-well.ilk.org) ([66.92.78.145]) (envelope-sender ) by mail21.sea5.speakeasy.net (qmail-ldap-1.03) with SMTP for ; 6 Oct 2005 17:49:19 -0000 Received: by be-well.ilk.org (Postfix, from userid 1147) id A78322D; Thu, 6 Oct 2005 13:49:18 -0400 (EDT) Sender: lowell@be-well.ilk.org To: freebsd-doc@freebsd.org References: <20051006135047.B0AB91551@fury.csh.rit.edu> <20051006074516.3F3251551@fury.csh.rit.edu> <20051006080941.GD2627@soaustin.net> <20051006170801.GB20088@soaustin.net> From: Lowell Gilbert Date: 06 Oct 2005 13:49:18 -0400 In-Reply-To: <20051006170801.GB20088@soaustin.net> Message-ID: <443bnezgbl.fsf@be-well.ilk.org> Lines: 36 User-Agent: Gnus/5.09 (Gnus v5.9.0) Emacs/21.3 MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Subject: Re: FAQ Updates 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: Thu, 06 Oct 2005 17:49:20 -0000 linimon@lonesome.com (Mark Linimon) writes: > On Thu, Oct 06, 2005 at 09:50:47AM -0400, Jordan Sissel wrote: > > The handbook would be an excellent place for such information! Great way > > to consolidate most of the "how to use FreeBSD" information even better > > into one location. Etc, etc. Preaching to the choir, eh? > > Yeah, really this has been discussed several times in the past and there > are several people who want things to head in this direction, but each > of them has other higher-priority items. (read: I personally am way to > overcommitted to do this ...) I am occasionally tempted to write up a "top ten most frequently asked questions on freebsd-questions" list. > > Would the FAQ work like this, then? > > > Q: How do I do *foo*? > > A: Check out *this* (with a happy link) entry in the handbook! > > Well, my own view (which may be a minority one) is that the FAQ should > be more like: > > Q: What are (the goals|the development process|) of the FreeBSD > Project? > A: > > Q: How do I find out information about how *foo*? > A: Check out *this* (with a happy link) entry in the handbook! > > And not have very many entries of the latter form. I think the FAQ should literally be a collection of Frequently Asked Questions and their answers. One of the problems we have is that there is no obvious place to put short answers to *in*frequently asked questions. Particularly "how do I" questions.