Hacker News new | ask | show | jobs
by raverbashing 4569 days ago
Exactly that

Coders: don't give me any BS like x = x + 1 /* Increment x */

Rather, tell me, if it's not obvious, WHY are you doing that

2 comments

There should rarely be any comments on why x is being incremented unless there is something particularly clever about why. Commentary should be reserved for program blocks where something non-obvious is happening or where something obvious is happening for non-obvious reasons, IMHO.
To increment x
Why do you need to increment?
Because it needs to be bigger.
Then make it times 2. Or add 5.