3 ms·
Not the OP, my two cents: Comments should be written only when there is (hidden) complexity or external context strictly required. Otherwise it is just easier
by arw0n 1mo ago
Not the OP, my two cents:
Comments should be written only when there is (hidden) complexity or external context strictly required. Otherwise it is just easier to read the code. Comments then signal one of two things: a) the following code is really complex and I need to tread carefully, or b) this code is complicated, and could benefit from a refactor.
In regards to agentic coding, all these comments are extra contents, driving down quality while increasing cost. Agents also tend to be inconsistent about updating comments, I've had cases repeatedly where a comment did not match the code, at which point it is just a documentation liability.