On Mon, 26 Jun 2000, Garst R. Reese wrote:
>
> The problem of coders (techies in general) not being good at documenting
> their own work is presumably well known. If not, RTFM for examples. The
> problem is exacerbated by the simple fact that many of the best
> developers have english as a second (or third) language, but most of the
> problem stems from the fact that the explanation seems "obvious" to the
> coder.
Nicely stated. I can do it, teach it, and show it, but writing about is
impossible......or close.
> I would like to suggest a linux-kernel-documentation list that writers
> could subscribe to. Developers would submit their needs for
> clarification to this list, possibly with a copy or notes in their
> native tongue. Writers would request clarification where necessary and
> write a clean explanation to go into linux/Documentation.
Pinch/kick me is the is a dream.....
Where are you going to find the folks to care on this task?
Cheers,
Andre Hedrick
The Linux ATA/IDE guy
-
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/
This archive was generated by hypermail 2b29 : Mon Jun 26 2000 - 21:00:09 EST