From owner-freebsd-doc Wed Apr 7 12:34:16 1999 Delivered-To: freebsd-doc@freebsd.org Received: from nothing-going-on.demon.co.uk (nothing-going-on.demon.co.uk [193.237.89.66]) by hub.freebsd.org (Postfix) with ESMTP id 644E315852 for ; Wed, 7 Apr 1999 12:34:10 -0700 (PDT) (envelope-from nik@nothing-going-on.demon.co.uk) Received: (from nik@localhost) by nothing-going-on.demon.co.uk (8.9.2/8.9.2) id TAA51584; Wed, 7 Apr 1999 19:08:46 +0100 (BST) (envelope-from nik) Date: Wed, 7 Apr 1999 19:08:46 +0100 From: Nik Clayton To: Sue Blake Cc: Bill Fumerola , Nik Clayton , Duncan Barclay , doc@FreeBSD.ORG Subject: Re: Organisation change for the Handbook Message-ID: <19990407190846.A39696@catkin.nothing-going-on.org> References: <19990406190353.C6083@catkin.nothing-going-on.org> <19990408005810.34644@welearn.com.au> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <19990408005810.34644@welearn.com.au>; from Sue Blake on Thu, Apr 08, 1999 at 12:58:10AM +1000 Organization: Nik at home, where there's nothing going on Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu, Apr 08, 1999 at 12:58:10AM +1000, Sue Blake wrote: > But how do we induce people to fill in the old ignored bits, like the > missing X section? Would it help to have a monthly posting to -doc > listing what documentation is sorely lacking and what's currently being > worked on? Keep lowering the barrier to contributing. At the moment, the Handbook is probably a bit daunting. It's big, it's complex, you need to read it if you want to write to it's style (such as there is one). What you want to write might not fit in properly, or cross over some existing sections. By breaking it up in to chunks it should be an easier task to contribute from the perspective of a potential author. I'm still working on the primer, to make it easier for people to get up to speed on how to contribute most effectively to the Doc. Proj. as well. I'm also not averse to making it easy for other doc groups to stick documentation in there. The GNOME and KDE folks are switching to DocBook, as is the Linux Documentation Project as a whole. I'd be *very* happy to see a consensus emerge as to a useful approach we can share -- the vast majority of Linux or FreeBSD documentation is, in fact, Unix documentation. There's a couple of other messages about this from Lars posted today. N -- Bagel: The carbohydrate with the hole To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message