| |||||||||||
|
| |||||||||||
Kernel Summit 2006: DocumentationKernel Summit 2006: DocumentationPosted Jul 18, 2006 10:26 UTC (Tue) by kleptog (subscriber, #1183)Parent article: Kernel Summit 2006: Documentation ... or requiring kernel developers to write man pages for any APIs they add. While the last one might seem like a good idea, Linus made the claim that "a lot of kernel developers have huge problems communicating with humans." Forcing them to write documentation might not be in anybody's best interest. Which is why we have people called "editors". The developers don't need to write brilliant documentation. As long as they can succinctly and clearly describe the interface, some time later someone can come along and make it readable for normal people.
(Log in to post comments)
agreed Posted Jul 18, 2006 23:32 UTC (Tue) by ccyoung (subscriber, #16340) [Link] this has other advantages as we, namely participation and ownership by a whole new set of people, such as myself, whose C days are long behind.
|
|||||||||||