When you are writing code, constantly ask yourself, “Is my intent clear to someone reading this code? Does the code speak for itself? Is there anything mysterious here? Are there any hidden meanings?” Even though something is obvious in your mind at the moment you are typing in the code, that does not mean that it will be obvious to you six months from now, or to someone else tomorrow. Strive to make your code self-documenting, and where you fall short of that goal (which even the best programmers do – self-documenting code can be an elusive goal), use good comments to make things more clear.
First
Next