3 ms·
> and which ones do you find counterproductive? Now that one's easy: when some joker changes the code and ignores the commentary right above the affected line
by mdaniel 4y ago
> and which ones do you find counterproductive?
Now that one's easy: when some joker changes the code and ignores the commentary right above the affected line (I know this is a silly example, because this comment is more-or-less restating what the code does, but I have a hard time distilling the actual cases I encounter at $JOB into a tl;dr)
// if the list came back empty, warm the local cache
- if (items.isEmpty()) {
+ if (items.size() == 1) {
I do have some sympathy for not changing the method docs, or class docs, or a completely separate file that describes the code's behavior, but not reading the *but it's right there* drives me bananas