Comment Re:This is not human languages! (Score 1) 413
The key to bluGill's entreaty to comment code is the ability to understand intent. THIS IS IMPORTANT. Comments are not. They should be used when the intent of the code is not clear. It is preferable to make the code clear in and of itself. In most cases, the use of descriptive varible names joined with functions that organize logic do quite nicely.
Remember Norm Schryer's dictum:
If the code and comments disagree, both are probably wrong!
The best way to avoid this
Remember Norm Schryer's dictum:
If the code and comments disagree, both are probably wrong!
The best way to avoid this
