Comment Re:Cliche, but true... (Score 1) 580
Yes, also: if some intern was fixing a problem with your code, and they were sitting next to you, what sort of things would you have to explain to them in order for them to understand and fix your code, and not just dis' it to their boss and tell their boss what a load of crap your code is?
I often imagine I'm explaining to an intern how the code works when I write my comments. I assume they understand the language, the libraries and stuff - they can just Google that stuff - but what does this class do? why? Target audience.
The other possible target audience is myself in a year's time.
To be honest, the longer I code, the more these target audiences converge on writing the same set of comments