Great article. I mostly agree with you but how would you apply your "what" vs "why" rule to e.g. public API interface methods? Isn't it useful to provide some form of information using comments?