All programmers know the importance of code-commenting, naming functions sensibly, maintaining a disciplined folder structure, writing consistent and well-structured code, etc. etc.
Yet sometimes you just don’t get around to doing all this, which is foolish and expensive in the long run. A minimum of extra effort pays dividends in the form of fewer bugs and much time saved. If you ever hear a programmer say that “the code itself is the best documentation”, he or she has never had to do maintenance on other programmers’ code. Or his own, for that matter.
So – to keep ourselves in line, we follow the Code Conventions given below. All check-ins in our source code system are checked by our reviewer for adherence with the Code Conventions. If you develop iPhone apps, this link may come in handy for you, too:
