Quote:
|
Originally Posted by Mark McLeod
For general consumption I think we'll need to be able to condense the major points to one or two sheets of bullets that is then backed by the in-depth standard definition and reasoning.
|
Maybe this
article will help? (Ignore perl specific stuff, obviously.) Specifically:
Quote:
Coding standards needn't be onerous. Just because there are bad coding standards out there, doesn't mean that all coding standards are bad.
I think the way to a good coding standard is to be as minimalist as possible. Anything more than a couple of pages long, or which deviates too far from common practice, will frustrate developers and won't be followed. And standards that are too detailed may obscure the fact that the code has deeper problems.
|
This sounds like a really good idea, and I hope it proves successful.