From owner-freebsd-stable@FreeBSD.ORG Thu Dec 28 13:23:12 2006 Return-Path: X-Original-To: freebsd-stable@FreeBSD.org Delivered-To: freebsd-stable@FreeBSD.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 5113216A407; Thu, 28 Dec 2006 13:23:12 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: from mail.soaustin.net (mail.soaustin.net [207.200.4.66]) by mx1.freebsd.org (Postfix) with ESMTP id 37BC713C47A; Thu, 28 Dec 2006 13:23:12 +0000 (UTC) (envelope-from linimon@lonesome.com) Received: by mail.soaustin.net (Postfix, from userid 502) id C8B04614; Thu, 28 Dec 2006 07:23:11 -0600 (CST) Date: Thu, 28 Dec 2006 07:23:11 -0600 To: "Eric P. Scott" Message-ID: <20061228132311.GA22749@soaustin.net> References: <200612281254.kBSCscUU027061@anna.ana.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <200612281254.kBSCscUU027061@anna.ana.com> User-Agent: Mutt/1.5.9i From: linimon@lonesome.com (Mark Linimon) Cc: freebsd-stable@FreeBSD.org, "Simon L. Nielsen" Subject: Re: FreeBSD 6.2-RC2 Available X-BeenThere: freebsd-stable@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Production branch of FreeBSD source code List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Thu, 28 Dec 2006 13:23:12 -0000 On Thu, Dec 28, 2006 at 04:54:38AM -0800, Eric P. Scott wrote: > You need to try to put yourself in an end user's frame of reference. It's > easy to understand why even fairly experienced folks can find FreeBSD > documentation baffling. The FreeBSD Documentation Project is always in search of new volunteers. There are parts of the documentation that are, to put it charitably, a little bit dusty. (Clearly the preferential listings for floppies speaks of this). See http://www.freebsd.org/docproj/ for the best introduction on what the doc project is, and how to contribute. We have mailing lists (one for -doc, and one for -www; the latter is about things that appear only on the website). We also have an IRC channel. Basically, we have much more work than available volunteers right now. I think you have some good ideas; the best thing, of course, would be if you could develop patches (the subset of SGML that we use is really not a very difficult markup language to learn), but if not, perhaps you can participate on the freebsd-doc@ mailing list and see if you can attract any interest in specific proposals. Further discussion on this topic should probably go to -doc rathern than -stable. Thanks. mcl