Date: Wed, 7 Apr 1999 19:08:46 +0100 From: Nik Clayton <nik@nothing-going-on.demon.co.uk> To: Sue Blake <sue@welearn.com.au> Cc: Bill Fumerola <billf@chc-chimes.com>, Nik Clayton <nik@nothing-going-on.demon.co.uk>, Duncan Barclay <dmlb@ragnet.demon.co.uk>, doc@FreeBSD.ORG Subject: Re: Organisation change for the Handbook Message-ID: <19990407190846.A39696@catkin.nothing-going-on.org> In-Reply-To: <19990408005810.34644@welearn.com.au>; from Sue Blake on Thu, Apr 08, 1999 at 12:58:10AM %2B1000 References: <19990406190353.C6083@catkin.nothing-going-on.org> <Pine.HPP.3.96.990407103039.17672E-100000@hp9000.chc-chimes.com> <19990408005810.34644@welearn.com.au>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?19990407190846.A39696>