Kernel Summit 2006: Documentation
Posted Jul 18, 2006 10:26 UTC (Tue) by kleptog
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.
to post comments)