cm  
 

Coding Conventions

 

I think that a good coding convention contains or covers

  • quick reminder about why we should have coding conventions (including links to quantitative research)
  • lexical considerations (naming, whitespace, etc)
  • class layout
  • file layout
  • directory layout
  • language features (allowed and disallowed)
  • abstraction rules
  • abstraction mechanisms
  • build process
  • testing

Coding convention thoughts:

http://www.joelonsoftware.com/articles/Wrong.html

brian mentioned a bunch of studies that showed that coding conventions were a good thing. he thought that Code Complete might have references to them.