The Judgment Log at the Engineering Station: What to Write, What to Skip
The last post left the engineering station with a one-line test: if the reasoning behind a decision would be useful to the engineer who touches this code in six months, write it down. That test tells you what deserves an entry, but it does not tell you how to recognize the moment, in the middle of a session, when you have crossed from accepting a suggestion into making a decision. Those are different skills, and the second one is a skill nobody ever had to develop before. ...