LinuxConf.eu: Documentation and user-space API design
Posted Sep 4, 2007 19:37 UTC (Tue) by njs
Parent article: LinuxConf.eu: Documentation and user-space API design
Surely it would not be too much to ask people submitting patches to write, if not documentation in English, at least documentation in code?
I mean, they're testing their patch somehow, usually with some ugly hacked up code. It would not be dramatically more work to just require them to additionally meet basic code cleanliness standards, exercise the full interface, and always send in the code? Then at least one person has had to bang their head against using the interface, and there is some kind of full specification written down (even if not in the most convenient form)...
to post comments)