6 ms·
Comments are meant to pass information to readers about rare cases that may not make much sense at first but have a reason to be. This is to avoid the introduc
by Mizoguchi 3y ago
Comments are meant to pass information to readers about rare cases that may not make much sense at first but have a reason to be.
This is to avoid the introduction of bugs by tempting someone to refactor or "fix" your code.
A properly written code, with good naming conventions for parameters, variables and functions should be easy to understand without comments.
I should not need anyone to tell me the next few lines will
//Heat oven
That should be self explanatory by just looking at the code itself.