3 ms·
"90% of the time I wind up subconsciously ignoring comments that exist in code." That's ok - because they are there for reference purposes. So you can ignore
by edblarney 10y ago
"90% of the time I wind up subconsciously ignoring comments that exist in code."
That's ok - because they are there for reference purposes.
So you can ignore them most of the time.
When there's an issue, or you are reading unfamiliar code - you can reference them.
I leave notes in the code as to the oddities/undocumented nature of weird API dependencies, and of things that were tried in the past and failed.
So many times I've tried to compile some off-the-shelf thing and failed because I didn't read the release notes.
You just have to read the release notes :)
So when you're perusing an unfamiliar module, read the comments :)
I grasp that they can become stale, but on the whole, decent comments are better than none.