Writing for engineers

Writing for engineers
who care about the
inside of the machine.

Long-form essays, postmortems, and field notes on systems, performance, AI, and the discipline of shipping.

Browse by categoryRSS
12 essays
12 essays
Learning PathJun 26, 2026

The Reluctant 'Handbook' to the Managed Configuration Processor (MCP)

After surviving another config cascade, someone asked for an MCP handbook. Fine. Here's a 'guide' to the Managed Configuration Processor: what it pretends to be, how to poke it, and why it'll still eat your weekend.

Youssef El Hejjioui·5 min read
Learning PathJun 25, 2026

The Outbox Pattern: When 'Commit and Publish' Just Isn't Cutting It Anymore

We've all been there: a critical business event vanishing between a database commit and a message broker publish. The outbox pattern, born from distributed system pain, ensures your microservices don't lie about their state.

Youssef El Hejjioui·8 min read
Learning PathJun 24, 2026

Understanding Backpressure in Apache Kafka

Late-night debrief on Kafka backpressure: why your producers block, consumers lag, and how production systems truly buckle under load. It's not in the tutorials, it's what keeps you up at 3 AM.

Youssef El Hejjioui·8 min read
Learning PathJun 24, 2026

When The Domain Fights Back: Untangling Production With Bounded Contexts

Ever stared at a stack trace at 3 AM and realized your "customer" means five different things across the codebase? That's the messy reality DDD's core concepts try to tame. This isn't about fancy patterns; it's about not getting punched in the face by your own system.

Youssef El Hejjioui·9 min read
Learning PathJun 23, 2026

UML: Because Sometimes You Need a Map When the Ship's on Fire

We've all been there: staring at logs at 3 AM, wondering why

Youssef El Hejjioui·8 min read
Learning PathJun 23, 2026

When Your ORM Calls In Sick: Surviving Production With Raw SQL

Remember that 3 AM call? When the ORM folded, and the DBA was unreachable? Yeah. This is about what saves your ass then: raw SQL, from CRUD to the dark magic of indexes and window functions.

Youssef El Hejjioui·5 min read
Learning PathJun 21, 2026

Git and GitHub: Surviving the Source Control Gauntlet (and Beyond)

Cut through the noise and the terror of Git. This isn't a 'five easy steps' tutorial. This is about what actually matters when you're waist-deep in a production incident, trying to understand why a 'simple' change blew everything up.

Youssef El Hejjioui·7 min read
Learning PathJun 20, 2026

So, You Want a Distributed System? Bless Your Heart.

Let's be real about distributed systems. It's not a whiteboard exercise; it's a production battle. We'll talk about why we end up building these things, and why they relentlessly try to break our spirits at 3 AM.

Youssef El Hejjioui·5 min read
Learning PathJun 20, 2026

When Your Threads Start Eating Your Server: Understanding Thread Pools Beyond The Hype

Another late night debugging a thrashing service? This is a debrief on why thread pools exist, when they actually save your ass in production, and the ugly truths you'll learn when you inevitably get them wrong.

Youssef El Hejjioui·9 min read
Learning PathJun 19, 2026

Consistent Hashing: Avoiding the Great Distributed System Reset Button

Ever had your distributed cache spontaneously combust because you added a node? Or watched your sharded database rebalance into oblivion? That's where consistent hashing steps in, not as a magic bullet, but as the lesser evil for managing change in a chaotic world.

Youssef El Hejjioui·9 min read
Learning PathJun 18, 2026

The Real Theories That Scale Your Skills (Not The Ones On LinkedIn)

Forget the whiteboard dogma and AI-generated architecture diagrams. Scaling isn't about knowing fancy academic theories; it's about understanding how systems actually break under pressure and what that 3 AM pager call truly means for your code.

Youssef El Hejjioui·5 min read
Learning PathJun 16, 2026

PgBouncer: The Connection Wrangler You Didn't Know You Needed (Until Everything Exploded)

When your PostgreSQL instance is choking on connections at 3 AM, PgBouncer often rides in. This isn't a tutorial, it's a debrief on why it matters, where it hurts, and how not to shoot yourself in the foot with it.

Youssef El Hejjioui·12 min read
12 articles · want to find something specific?Browse all by category →