From owner-freebsd-questions@FreeBSD.ORG Mon Jun 7 22:37:20 2004 Return-Path: Delivered-To: freebsd-questions@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 6D9A216A4CE for ; Mon, 7 Jun 2004 22:37:20 +0000 (GMT) Received: from priv-edtnes14-hme0.telusplanet.net (outbound03.telus.net [199.185.220.222]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0254043D1F for ; Mon, 7 Jun 2004 22:37:20 +0000 (GMT) (envelope-from cpressey@catseye.mine.nu) Received: from catseye.biscuit.boo ([154.20.76.195]) by priv-edtnes14-hme0.telusplanet.netSMTP <20040607223719.TBXR10524.priv-edtnes14-hme0.telusplanet.net@catseye.biscuit.boo>; Mon, 7 Jun 2004 16:37:19 -0600 Date: Mon, 7 Jun 2004 15:36:42 -0700 From: Chris Pressey To: "Goodleaf, John" Message-Id: <20040607153642.37489947.cpressey@catseye.mine.nu> In-Reply-To: References: Organization: Cat's Eye Technologies X-Mailer: Sylpheed version 0.9.10 (GTK+ 1.2.10; i386-portbld-freebsd4.9) Mime-Version: 1.0 Content-Type: text/plain; charset=US-ASCII Content-Transfer-Encoding: 7bit cc: freebsd-questions@freebsd.org Subject: Re: OT: group coding standards X-BeenThere: freebsd-questions@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: User questions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 07 Jun 2004 22:37:20 -0000 On Mon, 7 Jun 2004 13:10:06 -0700 "Goodleaf, John" wrote: > Hello, > I'm abusing the mailing list because many of you are sickeningly > clever and have long experience in IT. I'm working to establish a > document (yep) providing guidance for our company's > small-but-growing IT group with regard to coding standards and > practices. It seems rife with potential problems and there is > already the potential for one of those variable-naming holy wars > (e.g. intVariableName, varname, VarName, varName). Only one suggestion here: avoid 'varname'. It makes it more difficult for non-native-English speakers to parse, as they don't usually have an innate grasp of where one word should stop and the next word should begin. In fact, the problem is not restricted to those who learned English as a second language; how would *you* parse "opportunityisnowhere"? :) > So my question: > is there a good document out there on the net somewhere, maybe > hiding at a University site from which I can draw for general > consideration? Any experiences? Recommendations? style(9) has already been mentioned... personally, I like http://www.erlang.se/doc/programming_rules.shtml However, a lot of those rules are specific to Erlang and/or functional programming and/or distributed programming. > It's a hard problem. How do you provide conventions that don't > annoy the hell out of programmers, but which ensure that legibile, > maintainable code is left? Accept that you're going to annoy some of them no matter what you do, and don't worry about it further, I guess. > Any suggestions welcome. Please cc me directly, as I'm not > currently on this list. > > John -Chris