FreeBSD Kernel Internals Documentation

[Polytropon]

On Fri, 30 Dec 2011 10:22:31 -0500, David Jackson wrote:
> Of course, those best able to document are those who wrote it in
> the first place, since they already know how it works.

A fact seems to be: "Modern" programmers don't bother
with documenting, or coding guidelines, or style or
other things that "slow down" development. This
attitude isn't new in general, as it has been done
that way even in IT dinosaur times: There are COBOL
programs still running, and nobody knows _why_ they
are running and _how_. If someone had written usable
documentation at the time the program was created
and maintained, skilled COBOL h4x0rs wouldn't be
able to write the desired salary on the contract
as _they_ wish. :-)

But keep in mind: Writing code and writing documentation
are two different things. There are people who are
excellent coders, but bad writers. In some teams,
you'll find code writers and doc writers separated,
but working together. This approach isn't free of
problems, but also seems to work.


-- 
Polytropon
Magdeburg, Germany
Happy FreeBSD user since 4.0
Andra moi ennepe, Mousa, ...