/blog

Practical writing for working developers. Debugging, docs, architecture, career — the stuff we wish we'd read five years ago.

System Design Diagrams That Don't Suck

Dec 16, 2025

Why most architecture diagrams fail, the four types every engineer should know, and a pragmatic guide to drawing one that actually helps the reader understand what you built.

#architecture#design#documentation

What is MCP? The Model Context Protocol, Explained

Dec 9, 2025

A developer's introduction to the Model Context Protocol — what it is, why Anthropic built it, how it differs from tool-use APIs, and how to wire your first MCP server in under 20 minutes.

#mcp#claude#tools#anthropic

Resume Bullets for Software Engineers: What Actually Lands Interviews

Dec 2, 2025

The structure, the verbs, and the numbers that make an engineering resume bullet worth reading. With 20 real before/after examples across frontend, backend, data, and infra.

#career#resume#interview

Dockerfile Best Practices: 10 Anti-Patterns to Stop Shipping

Nov 25, 2025

A tour of the ten Dockerfile mistakes that bloat images, leak secrets, and break caching. With the fix for each, plus the multi-stage pattern that solves most of them at once.

#docker#devops#security

Writing a Great README: The Developer's Checklist

Nov 18, 2025

What separates a README that gets stars from one that gets ignored. A practical checklist with examples — the eight sections every project needs and the three most teams skip.

#open-source#documentation#github

How to Read Python Stack Traces (Without Losing Your Mind)

Nov 12, 2025

A practical, no-fluff guide to decoding Python tracebacks — what each line means, how to jump straight to the real bug, and the five errors that cause 80% of Python pain.

#python#debugging#errors