No such thing as a small change | |
PerlMonks |
comment on |
( [id://3333]=superdoc: 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 reply to Re^2: Why programming is so much more than writing code
by bibliophile
|
|