When I was taking programming classes in college, comments were all the rage. Most of the solutions I handed in had one function (or very few), with comments above the class, above each function, within each function. Everywhere. Instructors wanted lots of comments. In retrospect, I’m not sure why.
Every few months, a nearby user group does a code kata du jour. Everyone pairs up, and uses common practices like TDD and red-green-refactor. A couple weeks ago, I was partnered with someone who hadn’t done this before, so I had the opportunity to talk him through it. Assuming