Date: Wed, 2 Aug 2000 22:36:25 +0200 From: Neil Blakey-Milner <nbm@mithrandr.moria.org> To: Doug Young <dougy@gargoyle.apana.org.au> Cc: Steve Fagan <sfagan@pmr.com>, msilver@sc.rr.com, "'freebsd-newbies@freebsd.org'" <freebsd-newbies@FreeBSD.ORG> Subject: Re: new books, changing my pt. of view Message-ID: <20000802223625.A36720@mithrandr.moria.org> In-Reply-To: <01a201bffcc0$9f2c6370$847e03cb@ROADRUNNER>; from dougy@gargoyle.apana.org.au on Thu, Aug 03, 2000 at 06:31:19AM %2B1000 References: <DBB3921EFE2AD211A81500A0C9B5FE760579452C@msg04.scana.com> <06a801bffc9d$73c1a9c0$1600010a@pmr.com> <014e01bffcb8$7d46fed0$847e03cb@ROADRUNNER> <20000802215841.A36147@mithrandr.moria.org> <01a201bffcc0$9f2c6370$847e03cb@ROADRUNNER>
next in thread | previous in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?20000802223625.A36720>