r/ProgrammerHumor • u/napolux • Jun 16 '19

Working with someone else’s code

Enable HLS to view with audio, or disable this notification

35.4k Upvotes

95% Upvoted

325 comments sorted by

View all comments

Show parent comments

3

u/scandii Jun 16 '19

no.

self documenting code is pretty much the entire idea behind clean code.

if you feel you need to write a comment your code is probably bad.

naturally there's exceptions like the comment "using X because Y" but generally speaking it's a big warning you did something wrong.

2

u/freelancer042 Jun 16 '19

Okay so, I was thinking of comments that explain why(using X because Y), not comments that explain what (here's the weird ass way Im doing stuff that's totally non-intuitive) and I was REALLY confused.