top | item 45996827

(no title)

eschneider | 3 months ago

Comments are a gift to future you. When you pick up the code again after 6 months/years/however-long-in-the-future and it looks like something you've never seen before, the comments you left should be notes you need to build context around what's in the code and (sometimes more importantly) what's NOT in the code.

discuss

order

reconnecting|3 months ago

This is one side, and this is something that I had in mind. However, I found that there is another popular opinion (1): that in reality, commented code is harmless. The problem is that it's messy and makes it difficult to read, etc.

1. https://softwareengineering.stackexchange.com/a/377187

JohnFen|3 months ago

That's not talking about informative comments, it's talking about commenting out code itself. That's an entirely different thing.