Talk is cheap - show me the code
As a pithy slogan it may be good, but it _could_ give the impression
that writing code alone is enough. This is especially tempting
when writing code comes easier to you than writing documentation.
On top of this uber-hackers tend to dismiss code cleanup,
documentation etc., as low-hanging fruit.
The point that Harold Welte made in his FOSS.in talk this year is
worth recalling here. (It seems to be to also be an undercurrent in
the article being commented on.)
The best FOSS code is written to be read by other humans
Of course it _should_ also run efficiently on a real computer
and so on, but FOSS code that is not a good read is not reviewable
To make this easier for those for whom English is not a comfortable
language, we should ask the following question:
Will reviewers be willing to accept documentation in languages other
Copyright © 2017, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds