"Show me your flowcharts and conceal your tables, and I shall continue to be mystified. Show me your tables, and I won’t usually need your flowcharts; they’ll be obvious." Fred Brooks, The Mythical Man-Month
The code tells you how. The comments tell why. That is, they tell the changes to your data structures (tables) the code is making.
Authored Comments
A very good article. Glad to see Perl being promoted.
"Show me your flowcharts and conceal your tables, and I shall continue to be mystified. Show me your tables, and I won’t usually need your flowcharts; they’ll be obvious." Fred Brooks, The Mythical Man-Month
The code tells you how. The comments tell why. That is, they tell the changes to your data structures (tables) the code is making.