Comments Explaining The Comments

Comments Explaining The Comments
code-comments-memes, documentation-memes, redundant-code-memes, code-quality-memes, clean-code-memes | ProgrammerHumor.io
Oh honey, you thought writing comments would make your code clearer? THINK AGAIN. Here we have the glorious phenomenon of redundant documentation taken to its most absurd extreme. It's like having a sign that says "STOP" and then adding another sign underneath that helpfully explains "THIS IS A STOP SIGN" because apparently we're all collectively suffering from severe brain fog.

This is what happens when developers follow "best practices" a little TOO literally. Someone told them to write clear comments, so they went full inception mode and started documenting their documentation. Next thing you know, they'll add a third sign explaining what "THIS" means. The tragedy is that we've ALL written code like this at some point—comments so painfully obvious they might as well say // This line of code is code.

More Like This