Clean Code: First Edition Critique - Clean Code - Critical Analysis

Clean Code Critique: Why Much of 'Clean Code' Aged Poorly (+ Better Alternatives)

Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Auto

Light

Rust

Coal

Navy

Ayu

Clean Code - Critical Analysis

Clean Code - Critical Analysis

Clean code is probably the most recommended book to entry level engineers and junior developers. While it might have been good recommendation in the past, I don't believe that's the case anymore.

After revisiting the book in 2023 I was surprised to notice that:

The book hasn't aged well

Much of its advice ranges from questionable to harmful

Examples are the worst part of the book. By any objective metrics, many would qualify as "bad code."

Lazer focus on a wrong thing and attempt to sell it as the solution to everything. Code readability is important, it is not the only one aspect

Despite being an entry-level book, it has these vibes of implied superiority, potentially giving the readers an undeserved sense of expertise

For a significantly shorter critque of the book, check out qntm's critique.<br>I mostly agree with qntm assessment. But it's a bit too emotional and personal and doesn't cover the parts i find the most harmful.

Recommended Alternatives

If you're just starting your career and seeking books to improve your coding skills, I suggest these instead:

A Philosophy of Software Design

While not explicitly positioned as such, this book effectively counters many "Clean Code" principles.<br>It's particularly helpful for unlearning Clean Code style of coding.

The Art of Software Design: Balancing Flexibility and Coupling<br>A deep dive into software complexity through abstraction, coupling, and modularity. It works as an excellent companion to "A Philosophy of Software Design".

Also Robert Martin is working on the second edition of Clean Code. It will be fun to see how much of this critique will become irrelevant 😃

Intended Audience

For those recommending "Clean Code" :

You may have read the book over a decade ago and found it useful at the time. This might help you reconsider.

For those confused after reading "Clean Code" :

You’re not alone. The book can be confusing, and you might find better practical advice in modern alternatives

For those who enjoyed "Clean Code" :

"It's great when people get excited about things, but sometimes they get a little too excited."

I hope this critique would help you to see more nuance.

A Note to All Readers

This page exists as a reference for anyone. Agree or disagree, contributions to the critique are welcome via GitHub.