more useful options | |
PerlMonks |
Re^2: Why programming is so much more than writing codeby bibliophile (Prior) |
on May 08, 2007 at 14:28 UTC ( [id://614148]=note: print w/replies, xml ) | Need Help?? |
Self-documenting code is good, yes. Necessary, even.
But at best it can only tell you *what* the code does. Sometimes the *why* is obvious, sometimes not. A good function name can help, but still.... Personally, I like to see even a one-line blurb on why the function exists. It helps me build (or re-build) that mental map of the system. Something like:
In Section
Meditations
|
|