Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 18 Jun 2001 16:37:32 -0400
From:      Michael Lucas <mwlucas@blackhelicopters.org>
To:        Nik Clayton <nik@nothing-going-on.demon.co.uk>
Cc:        Szilveszter Adam <sziszi@petra.hos.u-szeged.hu>, freebsd-advocacy@FreeBSD.ORG
Subject:   Re: BSD User Group Tips
Message-ID:  <20010618163732.A33060@blackhelicopters.org>
In-Reply-To: <0106151129530X.37769@clan.nothing-going-on.org>; from nik@nothing-going-on.demon.co.uk on Fri, Jun 15, 2001 at 11:29:53AM %2B0100
References:  <20010613120321.A92103@superhero.org> <000901c0f566$845e0f40$1401a8c0@tedm.placo.com> <20010615105306.E1744@petra.hos.u-szeged.hu> <0106151129530X.37769@clan.nothing-going-on.org>

next in thread | previous in thread | raw e-mail | index | archive | help
On Fri, Jun 15, 2001 at 11:29:53AM +0100, Nik Clayton wrote:
> Most definitely -- even a "Here is how I did it, it might not work for you" 
> document is a great start, because it provides something that can be 
> incrementally improved.

There have never been a shortage of -doc folks willing to DocBookize
plain text files.

I made this point at BSDCon last year, but it's worth repeating:

How to write documentation in 2 steps:

1) Write it so it doesn't suck
2) If it sucks, rewrite so it sucks less

The cooperative FreeBSD documentation process make part 2 *very* easy.
Given a technical clue, any number of folks are willing to provide,
say, grammar.

==ml

-- 
Michael Lucas
mwlucas@blackhelicopters.org
http://www.blackhelicopters.org/~mwlucas/
Big Scary Daemons: http://www.oreillynet.com/pub/q/Big_Scary_Daemons

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-advocacy" in the body of the message




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20010618163732.A33060>