From owner-freebsd-newbies Wed Aug 2 13:36:59 2000 Delivered-To: freebsd-newbies@freebsd.org Received: from ns1.sunesi.net (ns1.sunesi.net [196.15.192.194]) by hub.freebsd.org (Postfix) with ESMTP id 654FD37BEE3 for ; Wed, 2 Aug 2000 13:36:51 -0700 (PDT) (envelope-from nbm@sunesi.net) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 13K5FZ-0009ZV-00; Wed, 02 Aug 2000 22:36:25 +0200 Date: Wed, 2 Aug 2000 22:36:25 +0200 From: Neil Blakey-Milner To: Doug Young Cc: Steve Fagan , msilver@sc.rr.com, "'freebsd-newbies@freebsd.org'" Subject: Re: new books, changing my pt. of view Message-ID: <20000802223625.A36720@mithrandr.moria.org> References: <06a801bffc9d$73c1a9c0$1600010a@pmr.com> <014e01bffcb8$7d46fed0$847e03cb@ROADRUNNER> <20000802215841.A36147@mithrandr.moria.org> <01a201bffcc0$9f2c6370$847e03cb@ROADRUNNER> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <01a201bffcc0$9f2c6370$847e03cb@ROADRUNNER>; from dougy@gargoyle.apana.org.au on Thu, Aug 03, 2000 at 06:31:19AM +1000 Organization: Sunesi Clinical Systems X-Operating-System: FreeBSD 3.3-RELEASE i386 X-URL: http://rucus.ru.ac.za/~nbm/ Sender: owner-freebsd-newbies@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org On Thu 2000-08-03 (06:31), Doug Young wrote: > > As a documentor for the FDP, I have to say that there is no taboo > > against any form of coherent documentation, > > Actually my comment was "For some reason there appears to be a > > > taboo in FreeBSD against "step by step" instructions" Yes, I read it. And I repeat - there is no taboo against any form of coherent documentation, be it "step by step", or otherwise. > I have yet to see an official attempt at a "step by step" explanation of > anything. Look at http://www.FreeBSD.org/tutorials/dialup-firewall/article.html. It's the first of, I hope, a number of step-by-step "recipe" type documents. > The present docs are a dreadful jigsaw puzzle .... its rarely possible to > find ALL the info one needs in one place, if indeed the stuff can be found > (and comprehended) at all. Later on, I said something like "you're not notifying the documentation project". Whenever you run into a problem, immediately mail doc@FreeBSD.org, and it'll get fixed. If you can figure out how to use send-pr, even better, since we can track your suggestions better. If you don't notify the documentation project, _nothing_ will happen to change your irritation. Best yet, suggest what you'd like it to look like, or write the content, or learn how to make patches, or something to lessen the load of work on the other contributors, and increase your benefit to and from the project. Neil -- Neil Blakey-Milner Sunesi Clinical Systems nbm@mithrandr.moria.org To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-newbies" in the body of the message