Unpopular Opinion: If Your Code Needs Comments, You Wrote It Wrong.

●1 ●12 ●26
calendar_today • schedule1 min read

Senior devs love saying: "Good code is self-documenting."

My PR with clean, readable code: rejected for lack of comments.
My PR with comments everywhere: "Too many comments, code should speak for itself."

Bro, pick a lane. 😭

The 4 Types of Comments I Keep Seeing:

Type 1: The Obvious
// Increment counter by 1
counter++
Thanks, Captain Clarity. I was lost without you.

Type 2: The Ancient Scroll
// TODO: Fix this later - Jan 2019
Adam from 2019 left the company. So did his TODO.

Type 3: The Confession
// Don't ask why this works. I spent 6 hours. Just trust me.
Honestly? I respect this one.

Type 4: The Liar
// Validates user input
Function literally does 17 things including calling an external API. The comment hasn't been true since 2021.

Here's my spicy take: Comments should explain WHY, not WHAT. The WHAT is in the code. The WHY is the business logic, the edge case, the hack you had to ship at 2 AM.

Change my mind. Or agree with me. Either way, I want to hear YOUR take.

👇 Drop your thoughts:

  • Are comments a sign of good documentation or bad code?
  • What's the worst comment you've ever found in a codebase?
  • Do you write comments first, last, or never?

Let the comment wars begin. ⚔️

Want more #programming & #beginners deep dives?

Join 5,972+ developers sharing real benchmarks, code breakdowns, and projects. Free forever.

4 Comments

3 votes
2 votes
0
2 votes

More Posts

Frameworks Are Institutional Memory

Ken W. Algerverified - Sep 17

Your Tech Stack Isn’t Your Ceiling. Your Story Is

Karol Modelski - Apr 9

Cisco's Amy Chang: A Model's "Passport" Doesn't Tell You Where It Actually Came From

Tom Smithverified - Aug 27

TypeScript Complexity Has Finally Reached the Point of Total Absurdity

Karol Modelski - Apr 23

I’m a Senior Dev and I’ve Forgotten How to Think Without a Prompt

Karol Modelski - Mar 19
chevron_left
1.4k Points • 39 Badges
Zahir Pir, Pakistan • github.com/byllzz
8Posts
16Comments
6Connections
Building performant web experiences with React, TypeScript, Tailwind, and open source.

Related Jobs

View all jobs →

Commenters (This Week)

6 comments
5 comments
1 comment

Contribute meaningful comments to climb the leaderboard and earn badges!