[prev in list] [next in list] [prev in thread] [next in thread] 

List:       linux-kernel
Subject:    Re: Kernel developers
From:       Ron Flory <ron.flory () adtran ! com>
Date:       2000-02-17 22:36:05
[Download RAW message or body]

> } > Yes, you're right, they're writing good code. But the most important
> } > part of the job of a good programmer is writing a good documentation
> } > for other people. This job is disregarded by most of the kernel programmers.
> } > Its very hard to find actual and good documentation. Look at the KDE
> } > project, they do a better job.
> } >
> } Important?  Sometimes.  Most important?  Get real.
> }
> Important all the time (for any code worth someone looking at). However,
> programmers are not tech writers...

 without starting a pissing contest, documentation IS part of the job-
its not a fun part of the job, but its got to be done if somebody else
is expected to use or maintain your code.  

 From my experience, the best technical writers ARE programmers.

 Having said that, I'm just as guilty about not documenting my stuff as
the next guy- It takes a lot of time to follow through on a project, and
nobody ever has enough time...

peace-

ron

-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.rutgers.edu
Please read the FAQ at http://www.tux.org/lkml/

[prev in list] [next in list] [prev in thread] [next in thread]