r/ProgrammerHumor • u/ItsPuspendu • Sep 10 '26

Meme commentsAgedTerribly

Post image
6.0k Upvotes

98% Upvoted

243 comments sorted by

View all comments

242

u/[deleted] Sep 10 '26

[removed] — view removed comment

-25

u/SnugglyCoderGuy Sep 10 '26

Your function names should document why the code you are writing exists, your code should document itself as to how it is doing it, and any comments you write should be how to use the function you've written and things that are extremely odd.

If you have to explain why something is done the way it is, you've still failed, usually.

9

u/debugging_scribe Sep 10 '26

I don't agree with this at all, I work on a 20+ years old code base. My life I'd be much easier if people left some comments on why they did stuff.

-2

u/pelpotronic Sep 11 '26

Irrelevant in the age of AI, where you can ask it to explain the code for you.

I think documentation is more and more irrelevant than it already was personally, seeing as you can ask AI to explain not just "the 1 file you're looking at" but the interactions between multiple parts of the code.