From owner-freebsd-doc@FreeBSD.ORG Thu Oct 6 13:50:50 2005 Return-Path: X-Original-To: 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 0E70D16A41F for ; Thu, 6 Oct 2005 13:50:50 +0000 (GMT) (envelope-from psionic@csh.rit.edu) Received: from blacksheep.csh.rit.edu (blacksheep.csh.rit.edu [129.21.60.6]) by mx1.FreeBSD.org (Postfix) with ESMTP id 077EC43D49 for ; Thu, 6 Oct 2005 13:50:49 +0000 (GMT) (envelope-from psionic@csh.rit.edu) Received: from fury.csh.rit.edu (fury.csh.rit.edu [IPv6:2001:470:1f00:135:a00:20ff:fe8d:5399]) by blacksheep.csh.rit.edu (Postfix) with ESMTP id 0330F269F; Thu, 6 Oct 2005 09:50:48 -0400 (EDT) Received: from fury.csh.rit.edu (localhost [127.0.0.1]) by fury.csh.rit.edu (Postfix) with ESMTP id B0AB91551; Thu, 6 Oct 2005 09:50:47 -0400 (EDT) To: linimon@lonesome.com (Mark Linimon) In-reply-to: <20051006080941.GD2627@soaustin.net> References: <20051006074516.3F3251551@fury.csh.rit.edu> <20051006080941.GD2627@soaustin.net> Comments: In-reply-to linimon@lonesome.com (Mark Linimon) message dated "Thu, 06 Oct 2005 03:09:41 -0500." Date: Thu, 06 Oct 2005 09:50:47 -0400 From: Jordan Sissel Message-Id: <20051006135047.B0AB91551@fury.csh.rit.edu> Cc: doc@freebsd.org 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 13:50:50 -0000 On 6 October 2005 at 3:09, linimon@lonesome.com (Mark Linimon) wrote: > On Thu, Oct 06, 2005 at 03:45:15AM -0400, Jordan Sissel wrote: > > Apologiges if this isn't the proper point of contact for the FAQ. > > It is, but there is an "underground movement" of sorts to try to > take the technical information out of the FAQ and put it into the > Handbook. (This would leave the FAQ a 'what is FreebSD' resource). > The FAQ is at best duplicating the Handbook information but more often > than not is far behind it. > > Please see if you might think the Handbook might be a better place for > this updated information. > > mcl 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? 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! If so, then how should the new entries into the handbook be organized? The handbook thusfar seems to be a very neatly organized set of articles relating to a large number of topics. Most articles being atleast a page long. With FAQ entries being usually 2-5 sentence answers, typically not meriting a whole article for dedication. I assume there are already ideas surrounding FAQ answer organization into the handbook? At this point I'm not quite sure how it would work, but the plan of having the FAQ not duplicate information already in the handbook is a great one. It has the added benefit of directing people from "How do I do this" to the handbook much faster than, say, googling for something random hoping to find a howto. Again, great idea. How can I help? Regards, -Jordan