The key is to write well-documented code, and not to rely on the widespread myth that code can be self-documenting. It seldom is.

IF the code is shorter than the associated comments, then it's not well documented, and if the code listing is shorter than the documentation, written and accepted BEFORE the first character of code was composed, then there probably hasn't been enough pre-coding thought invested.

RE