Self-documenting code is good, yes. Necessary, even.
in reply to Re: Why programming is so much more than writing code
in thread Why programming is so much more than writing code
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.
# Data comes back from the DB sorted by x,y,z.
# If the user wants a different order, here's where we do it.