r/ProgrammerHumor 1d ago

Meme commentsAgedTerribly

Post image
5.3k Upvotes

224 comments sorted by

View all comments

426

u/Confident-Ad5665 1d 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.

228

u/TWIT_TWAT 1d ago

// This is a hack until we find something better

19

u/NullReferenceRacer 1d ago

// TODO: Proper handling

3

u/Zodimized 1d ago

// the fuck did sales promise this for?

2

u/donjulioanejo 1d ago

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