I think you've hit on something and, for what it's worth, I encourage you to continue looking at this.
I write a lot of comments because it feels natural to me. For me, the *most* important obstacle to working with another's code (or my code that I haven't seen for a long time) is understanding the meaning behind it. With that priority, I sometimes write three times more lines of comments than lines of code.
It surprised me when I ran into someone who thought this was "too many comments." I came to understand that, for this person, the priority was to see as much code on the screen as possible. For him, my comments were "diluting" the code and making it harder to understand. I think I saw this reflected in the summary description when it mentioned "the clarity of comment-free code."
This was an important moment for me, in that I realized neither he nor I were "wrong," we just had different things that were important to us because we had different ways of understanding code.
The Schrodinger wave equation?
Oh - dang it - that's NOT the right address.
/agree
I thought the text you offered just then was pretty good.
If you think the system is working, ask someone who's waiting for a prompt.
