Re: White Paper on the Linux kernel VM?

From: Daniel Phillips (phillips@bonn-fries.net)
Date: Thu Jan 24 2002 - 13:21:19 EST


On January 24, 2002 05:06 pm, Denis Vlasenko wrote:
> Writing docs wastes developer's time: they will write how they want VM to
> operate or how they think it operates (while some bug can make actual VM
> operate differently) instead of improving/debugging current VM code.

No you're wrong. Not writing docs wastes the time of other developers. It
sends the message 'my time is more important than yours'. In the case of
Linus, that may be true, but it's very definitely not true for any other core
developer.

It is the responsibility of each developer to prepare at least minimal - but
sufficient - documentation for the work they do. Others who specialize in
preparing documentation can then use that material as a starting point for
preparing clearer, more extensive documentation. But if core developers shirk
their responsibility in this area, we will continue to suffer from a chronic
shortage of good, current kernel documentation.

--
Daniel

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



This archive was generated by hypermail 2b29 : Thu Jan 31 2002 - 21:00:22 EST