From owner-freebsd-advocacy Mon Jun 18 13:37:47 2001 Delivered-To: freebsd-advocacy@freebsd.org Received: from blackhelicopters.org (geburah.blackhelicopters.org [209.69.178.18]) by hub.freebsd.org (Postfix) with ESMTP id 96C4C37B401 for ; Mon, 18 Jun 2001 13:37:41 -0700 (PDT) (envelope-from mwlucas@blackhelicopters.org) Received: (from mwlucas@localhost) by blackhelicopters.org (8.9.3/8.9.3) id QAA33112; Mon, 18 Jun 2001 16:37:32 -0400 (EDT) (envelope-from mwlucas) Date: Mon, 18 Jun 2001 16:37:32 -0400 From: Michael Lucas To: Nik Clayton Cc: Szilveszter Adam , freebsd-advocacy@FreeBSD.ORG Subject: Re: BSD User Group Tips Message-ID: <20010618163732.A33060@blackhelicopters.org> 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> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2i 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 +0100 Sender: owner-freebsd-advocacy@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.ORG 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