From owner-freebsd-newbies Wed Aug 2 14:36:27 2000 Delivered-To: freebsd-newbies@freebsd.org Received: from goblin.apana.org.au (goblin.apana.org.au [203.3.126.3]) by hub.freebsd.org (Postfix) with ESMTP id C5CF237B70F for ; Wed, 2 Aug 2000 14:36:22 -0700 (PDT) (envelope-from dougy@gargoyle.apana.org.au) Received: (from uucp@localhost) by goblin.apana.org.au (8.8.8/8.8.8) id HAA17588; Thu, 3 Aug 2000 07:36:06 +1000 (EST) (envelope-from dougy@gargoyle.apana.org.au) Received: from roadrunner.apana.org.au(203.3.126.132), claiming to be "ROADRUNNER" via SMTP by goblin.apana.org.au, id smtpdc17586; Thu Aug 3 07:36:01 2000 Message-ID: <01be01bffcca$40e8b890$847e03cb@ROADRUNNER> From: "Doug Young" To: "SILVER, MICHAEL A" , "'Neil Blakey-Milner'" Cc: "'freebsd-newbies@freebsd.org'" , "'Rick Hamell'" References: Subject: Re: new books, changing my pt. of view Date: Thu, 3 Aug 2000 07:40:15 +1000 MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit X-Priority: 3 X-MSMail-Priority: Normal X-Mailer: Microsoft Outlook Express 5.00.2919.5600 X-MimeOLE: Produced By Microsoft MimeOLE V5.00.2919.5600 Sender: owner-freebsd-newbies@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > The problem lies in the gap between experienced UNIX admins and > inexperienced UNIX users, like myself (striving to be an admin). Certain > knowledge of UNIX is assumed, not purposely by the doc writers, but the doc > writer already have this knowledge. Many "newbies" simply don't have this > knowledge. This is something many of us have been saying for ages .... its because the people who write docs are typically extremely experienced that they are not the ideal people for the job. This issue is not something peculiar to FreeBSD, but certainly the situation is far worse with open source software than with commercial equivalents. It almost seems an insult to those that document FreeBSD to have > simple step by step instructions on doing very specific mundane tasks, > however this is what many of us require. Ummmm .... I just checked this was the right list, but yes it IS the "newbies" one so discussion relevant to newbies is presumably on the allowable list of topics ... heated or otherwise !!!!! Whats the purpose of documentation anyway ?? If it can't be readily comprehended by those who need it then its totally useless. Whilst many "die-hards" will shudder at the thought, providing a heap of screen dumps in the existing docs would go a long way toward filling in the gaps. The lack of complete info doesn't only concern newbies however .... even those of us who have been around IT for yonks struggle with something unfamiliar if its not documented properly. (To this day I refuse to purchase a VCR because I've yet to meet one that comes with intelligible instructions.) To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-newbies" in the body of the message