I’m about to undertake updating our coding standards documentation and I am thinking of perhaps writing them at a somewhat higher level than is commonly done. We have a fair amount of developers that come and go, and they are generally of an intermediate skill level. I want to eliminate the low quality “fluff” sections…for example, “variable naming conventions”, etc…anything that is really of dubious value, that distracts from the portions of the document that are of genuine value (which may be skimmed or skipped entirely due to excessive low value content).
I am also more interested in ensuring people don’t do stupid things, rather than forcing them do do things in a certain way.
We happen to be a .Net / Oracle shop, but for the type of material I am looking for, I don’t think language is particularly important.
I’m wondering if anyone has done this before and have some material they wouldn’t mind sharing, or has come across any good online material of a similar nature?
I definitely prefer a tooling option ReSharper over a standard document. The more I develop professionally, the more I realize that coding standard documents are a waste of time and they tend to be a productivity drain.
Code should be readable and understandable. Unfortunately, a coding standard cannot enforce either. Tools, however, can at least enforce naming conventions and help find problems such as failure to check for null, or “access to modified closure”.
Whatever the case, a coding standard should never keep developers from writing good code. I have seen documents that forbid the use of ternary operators or operator overloads. I have also seen documents that require that code be well commented (I try to avoid comments at all costs in favor of readable code). None of these things, in my opinion, should be in a coding standard.