From owner-freebsd-hackers Sat Jun 26 17: 1:39 1999 Delivered-To: freebsd-hackers@freebsd.org Received: from allegro.lemis.com (allegro.lemis.com [192.109.197.134]) by hub.freebsd.org (Postfix) with ESMTP id EBC1214CE0 for ; Sat, 26 Jun 1999 17:01:33 -0700 (PDT) (envelope-from grog@freebie.lemis.com) Received: from freebie.lemis.com (freebie.lemis.com [192.109.197.137]) by allegro.lemis.com (8.9.1/8.9.0) with ESMTP id JAA10888; Sun, 27 Jun 1999 09:31:26 +0930 (CST) Received: (from grog@localhost) by freebie.lemis.com (8.9.3/8.9.0) id JAA81771; Sun, 27 Jun 1999 09:31:25 +0930 (CST) Date: Sun, 27 Jun 1999 09:31:24 +0930 From: Greg Lehey To: Constantine Shkolny Cc: "hackers@FreeBSD.ORG" Subject: All this and documentation too? (was: Microsoft performance (was: All this and documentation too? (was: cvs commit: src/sys/isa sio.c))) Message-ID: <19990627093124.N427@freebie.lemis.com> References: <01BEBFCB.F95F6F00.stan@osgroup.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii X-Mailer: Mutt 0.95.4i In-Reply-To: <01BEBFCB.F95F6F00.stan@osgroup.com>; from Constantine Shkolny on Sat, Jun 26, 1999 at 12:03:59PM -0500 WWW-Home-Page: http://www.lemis.com/~grog X-PGP-Fingerprint: 6B 7B C3 8C 61 CD 54 AF 13 24 52 F8 6D A4 95 EF Organization: LEMIS, PO Box 460, Echunga SA 5153, Australia Phone: +61-8-8388-8286 Fax: +61-8-8388-8725 Mobile: +61-41-739-7062 Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG On Saturday, 26 June 1999 at 12:03:59 -0500, Constantine Shkolny wrote: > On Saturday, June 26, 1999 8:08 AM, Nick Hibma [SMTP:hibma@skylink.it] > wrote: >>> Programmers need documentation too. >> >> And they are going to scream like mad if there isn't any. But in the end >> they start reading the code anyway, even if there is docu, because they >> don't trust anything but their own eyes and brain. >> >> It's all documented in C anyway. > > I've come to understanding that lack of documentation is probably one of > the factors that keep the system healthy, because it keeps the unskilled > people away. I don't know whether it's true but I read in books that > reading code is one of the methods to learn programming. Since FreeBSD > does ship with source code, docs are not necessary. NT ships with poorly > written docs instead, and, that is what kills it all the time, despite of > its perfect design that I really like. People write NT drivers without > full understanding what is going on, so they destabilize the system. I can't agree with this theory. Lack of documentation just moves the degree of skill needed to, for example, write device drivers. Document less well and your average device driver writer will write a worse driver, with or without source code access. Source code access helps too, of course. Greg -- See complete headers for address, home page and phone numbers finger grog@lemis.com for PGP public key To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message