Using WEB documentation for kernel developement (Was: Re: Take A deep Breath - Kernel Documentation)

SirDibos (jwalther@citytel.net)
Mon, 21 Jul 1997 14:14:03 -0700 (PDT)


On Mon, 21 Jul 1997, Mark H. Wood wrote:
> Seriously, a well-made program product (there goes that ancient IBM stuff
> again) ought to have necessary but terse comments in the code, at close
> range so to speak, *and* a Program Logic Manual setting forth a
> framework that will last across a number of versions without getting too
> detailed. I know, I know, go then and do it....

I actually asked Linus once about using WEB for kernel developement. (3
years ago). His reply was basically, what is that? He didnt see a need
for it then, and it certainly hasnt hindered kernel developement.

Especially this wouldnt work because some major coders have atrocious
literary styles. True, half of the coders I know have very good writing
skill. But the other half... Their writing is so littered with errors
and horrible grammar that its more of a blessing that they dont write
documentation. Just think to coders that you know... and think about it
:>

Don Dibos

BTW, if you are trying to learn kernel concepts... The kernel
documentation is NOT the place to learn how. As the linux-kernel list FAQ
shows. And which same FAQ does refer you to some sources where you *can*
get an overview... and find example device drivers... etc.