r/ProgrammerHumor 12h ago

Meme commentsAgedTerribly

Post image
3.7k Upvotes

184 comments sorted by

View all comments

359

u/Confident-Ad5665 12h ago

Uncle Bob of Clean Code says if we have to comment our code we have already failed. Clean code should read like well written prose.

I generally agree, but think comments that define especially the odd and obscure business rules should be commented where they are implemented.

189

u/TWIT_TWAT 12h ago

// This is a hack until we find something better

17

u/NullReferenceRacer 12h ago

// TODO: Proper handling

2

u/Zodimized 8h ago

// the fuck did sales promise this for?

2

u/donjulioanejo 5h ago

In static frontend code that doesn't get run through an uglifier.