Re: Naming Conventions

I guess one good document is Scott Ambler's
http://www.ambysoft.com/downloads/javaCodingStandards.pdf

Some other which might be used for guidance are:

Gosling, J., Joy, B., Steele, G. (1996). The Java Language 
Specification. Reading, MA: Addison Wesley Longman Inc.
Ambler, S.W. (1998a). Building Object Applications That Work: Your 
Step-By-Step Handbook for Developing Robust Systems with Object 
Technology. New York: Cambridge University Press.

All of them argue in the favor of a notation as in [2].

Other possible notations are:
Hungarian notation (McConnell, S. (1993). Code Complete – A Practical 
Handbook of Software Construction. Redmond, WA:
Microsoft Press.)


- Adrian

Sandro Hawke wrote:
> Harold, you made changes to the Naming Conventions page [1] which seemed
> to me to combine editorial changes, changes to the conventions, and
> arguments motivating those changes.  I've refactored the page to try to
> clean that up.  I hope they all were true to the spirit of your edits.
>
> Meanwhile, I hear you arguing that the grammatical considerations are
> not appropriate in an international context -- that there's no reason
> class names or property names should be nouns/noun-phrases.  Is that
> right?  But the Java convention that class names should be nouns or noun
> phrases is very well accepted, isn't it?  [1] In fact, google's second
> hit (after [1]) on "class naming conventions") also supports the use of
> nouns for property names [2].
>
> I think the counter-argument against the conventions I'm proposing is
> that "ExistentiallyQuantifiedFormula" is too darn long, so "Exists" is
> fine.  But if that's the case, let's just have a convention that names
> be short, and justify the shorter names on those grounds, because there
> was no short noun-phrase name for this class.  
>  
>      -- Sandro
>
> [1] http://java.sun.com/docs/codeconv/html/CodeConventions.doc8.html
> [2] http://www.objectmentor.com/resources/articles/naming.htm#Nouns_Verbs
>
>

Received on Tuesday, 18 September 2007 08:38:15 UTC