LinuxConf.eu: Documentation and user-space API design
Posted Sep 4, 2007 23:05 UTC (Tue) by arnd
In reply to: LinuxConf.eu: Documentation and user-space API design
Parent article: LinuxConf.eu: Documentation and user-space API design
One point that Michael made in his talk was that it's useful to have the
documentation written by somebody other than the author of the code, in
order to increase the chances of finding bugs in the process.
Of course the requirement of having a documentation for everything is a
very good idea nonetheless and having both written by the same person can
only be better than no documentation at all.
Another problem we still need to work on is documentation for all the
existing code -- it's hard to make documenting new stuff a requirement
when there are so many examples of where we haven't done the documentation
in years. This is even more true for kernel internal interfaces than for
to post comments)