db-derby-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Daniel John Debrunner <...@apache.org>
Subject Re: [VOTE] Approve coding conventions for the Derby project
Date Fri, 18 Aug 2006 14:41:51 GMT
Oystein Grovlen - Sun Norway wrote:
> Rick Hillegas wrote:
> 
>> Clarity is the key goal of Derby's coding standards. The coding
>> guidelines at
>> http://java.sun.com/docs/codeconv/html/CodeConvTOC.doc.html are a style
>> primer, not a law book. Mine this document for good examples but use
>> your common sense. Feel free to disregard any advice which is religious
>> in nature or which would make your code brittle. Above all else, write
>> clearly.
> 
> As others have stated, the reason for having coding standard is that
> the code will be easier to read if the same style is used everywhere.
> It is the same reason that words have a defined spelling.  It makes
> documents much easier to read than if everyone came up with their own
> spelling.  In that light, your statement is similar to the following:
> 
>            "The Webster's Dictionary is a spelling primer, not a law
>            book.  Mine this document for good examples but use your
>            common sense."

I think that's too extreme, "code style" is more akin to "writing
style", not spelling.

Dan.


Mime
View raw message