Date: Mon, 14 Apr 2003 10:29:14 -0700 (PDT) From: Linus Torvalds To: John Bradford cc: vda@port.imtp.ilyichevsk.odessa.ua, Chuck Ebbert <76306.1226@compuserve.com>, linux-kernel Subject: Re: kernel support for non-English user messages In-Reply-To: <200304141255.h3ECtcFn000432@81-2-122-30.bradfords.org.uk> Message-ID: MIME-Version: 1.0 Content-Type: TEXT/PLAIN; charset=US-ASCII Sender: linux-kernel-owner@vger.kernel.org Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org X-Spam-Status: No, hits=-25.0 required=5.0 tests=AWL,EMAIL_ATTRIBUTION,IN_REP_TO,QUOTED_EMAIL_TEXT, REPLY_WITH_QUOTES,USER_AGENT_PINE,X_MAILING_LIST autolearn=ham version=2.53-osdl_revision__1.4__ X-Spam-Level: X-Spam-Checker-Version: SpamAssassin 2.53-osdl_revision__1.4__ (1.174.2.15-2003-03-30-exp) On Mon, 14 Apr 2003, John Bradford wrote: > > Anybody who doesn't document their code is wasting an opportunity to > improve their work. Some people care about documentation, some people don't. That's a fact, and spouting platitudes about "improving their work" just doesn't _matter_. The whole open source idea is that people do what they care about and what they are good at, and exactly because they aren't forced to deal with issues they don't have a heart for they take more pride and interest in the stuff they _do_ do. 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. And you know what? That _lack_ of comments and documantation improves my work. Not because documentation is bad, but because I DO NOT CARE. So I concentrate on the stuff I do care about. So no, people are _NOT_ "wasting an opportunity". Linus -