Articles / Developer Experience and DevRel

Developer Experience and DevRel

Why developers trust some technical content and bounce off the rest.

Code Documentation: Comments, Generated Reference, and External Guides
Decide what belongs in code comments, generated reference, and written guides so each reader can find the right kind of answer.
5 min read
Technical Writing for Engineers: The 80/20 Guide
Most engineering documentation fails for the same reasons. Here is what actually moves the needle.
12 min read
Quantifying the Engineering Velocity Impact of Technical Documentation
I analyze the structural correlation between documentation quality and engineering throughput, using DORA metrics and Accelerate research to quantify the ROI of technical writing.
10 min read
The Developer Trust Hierarchy: Why Practitioner Writing Outranks Marketing Content
I analyze the structural reasons why engineers filter for technical depth and verify-ability, creating a 5-tier hierarchy of developer trust.
9 min read
How Stripe's Technical Blog Became a Competitive Moat
I think Stripe’s technical blog compounds into a moat because it teaches, documents, and shapes developer trust long before a sales conversation starts.
11 min read
Why Devtools Startups Lose Deals Over Bad Docs
DevTools startups lose deals long before sales hears the objection. I explain how weak docs break evaluation, trials, and rollout confidence.
10 min read
From Engineer to Technical Writer: What I Kept and What I Left Behind
I explain which engineering habits still make me better at technical writing, which ones I had to drop, and how the day-to-day work changed.
9 min read
Technical Writing for AI Products: The New Rules
AI product docs now need prompts, schemas, evals, and version boundaries. I explain the rules I would use to judge a technical writer for an AI company.
12 min read