Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 26 Jun 1999 12:03:59 -0500
From:      Constantine Shkolny <stan@osgroup.com>
To:        "hackers@FreeBSD.ORG" <hackers@FreeBSD.ORG>
Subject:   RE: Microsoft performance (was: All this and documentation too? (was: cvs commit: src/sys/isa sio.c))
Message-ID:  <01BEBFCB.F95F6F00.stan@osgroup.com>

next in thread | raw e-mail | index | archive | help
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




Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?01BEBFCB.F95F6F00.stan>