From owner-freebsd-hackers Sat Jun 26 10: 2:24 1999 Delivered-To: freebsd-hackers@freebsd.org Received: from osgroup.com (unknown [38.229.41.6]) by hub.freebsd.org (Postfix) with ESMTP id 02F2014FB1 for ; Sat, 26 Jun 1999 10:02:19 -0700 (PDT) (envelope-from stan@osgroup.com) Received: from stan166 ([38.229.41.237]) by osgroup.com (8.7.6/8.6.12) with SMTP id LAA15171 for ; Sat, 26 Jun 1999 11:51:19 -0500 Received: by localhost with Microsoft MAPI; Sat, 26 Jun 1999 12:03:59 -0500 Message-ID: <01BEBFCB.F95F6F00.stan@osgroup.com> From: Constantine Shkolny Reply-To: "stan@osgroup.com" To: "hackers@FreeBSD.ORG" Subject: RE: Microsoft performance (was: All this and documentation too? (was: cvs commit: src/sys/isa sio.c)) Date: Sat, 26 Jun 1999 12:03:59 -0500 X-Mailer: Microsoft Internet E-mail/MAPI - 8.0.0.4211 MIME-Version: 1.0 Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Sender: owner-freebsd-hackers@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.ORG 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. To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-hackers" in the body of the message