From owner-freebsd-newbies Wed Aug 2 12:59:33 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 7380337BF75 for ; Wed, 2 Aug 2000 12:59:24 -0700 (PDT) (envelope-from nbm@sunesi.net) Received: from nbm by ns1.sunesi.net with local (Exim 3.03 #1) id 13K4f3-0009Rp-00; Wed, 02 Aug 2000 21:58:41 +0200 Date: Wed, 2 Aug 2000 21:58:41 +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: <20000802215841.A36147@mithrandr.moria.org> References: <06a801bffc9d$73c1a9c0$1600010a@pmr.com> <014e01bffcb8$7d46fed0$847e03cb@ROADRUNNER> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 1.0.1i In-Reply-To: <014e01bffcb8$7d46fed0$847e03cb@ROADRUNNER>; from dougy@gargoyle.apana.org.au on Thu, Aug 03, 2000 at 05:32:45AM +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 (05:32), Doug Young wrote: > I'm totally in favour of regular folks writing HOWTO docs, could never > understand > the logic of giving the job to propellorheads who write stuff that only > others of their ilk can comprehend. For some reason there appears to be a > taboo in FreeBSD against "step by step" instructions As a documentor for the FDP, I have to say that there is no taboo against any form of coherent documentation, and that I personally find it very disconcerting when the documents of the project, including my efforts ("The FreeBSD Booting Process", "Users and Basic Account Management", and "Disks" chapters in the handbook, to name the most recent) are commented against without any form of a) notification, b) suggestions, and c) content. All of our time is split between many tasks, and content-generation is possibly the biggest time spender you can find. If you really want to help out, submit your suggestions and content via send-pr (or, if you can't figure that out, to doc@FreeBSD.org), so that we know that people are reading things, and so we can improve things. Let me repeat my offer to any and all - if you generate the content, I will give suggestions, edit it, mark it up, and put it into the documentation project. You can submit in text or HTML, and I might even consider postscript or LaTeX. Don't let any pretense that there is a cost of admission fool you - just write it, and it will be considered. 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