lkml.org 
[lkml]   [2003]   [Apr]   [17]   [last100]   RSS Feed
Views: [wrap][no wrap]   [headers]  [forward] 
 
Messages in this thread
/
From
SubjectRe: kernel support for non-English user messages
Date
On Monday 14 April 2003 10:29, Linus Torvalds wrote:
> Personally, I don't write documentation. I don't much even write
> comments in my code. My personal feeling is that as long as
> functions are small and readable (and logical), and global
> variables have good names, that's all I need to do. Others - who do
> care about comments and docs - can do that part.

This is true, even from a software engineering perspective.

If you find yourself having to write comments and documentation to
explain your code, probably your identifiers are not well named, your
functions are not short enough, and your code is not well structured
enough.

Ideal code is completely self-documenting.

Eric


-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@vger.kernel.org
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/

\
 
 \ /
  Last update: 2005-03-22 13:34    [W:0.149 / U:0.264 seconds]
©2003-2020 Jasper Spaans|hosted at Digital Ocean and TransIP|Read the blog|Advertise on this site