All 55 articles, sorted alphabetically
API Design
How to design APIs that are consistent, evolvable, and pleasant to use.
Read article →Code Review
How to give and receive code reviews that improve code and spread understanding.
Read article →Debugging
How to debug systematically: reproduce, isolate, hypothesize, test, verify. Beats guess-and-check.
Read article →Documentation Culture
How to build a culture where documentation is written and maintained, not deferred.
Read article →Error Messages
How to write error messages that help users understand and fix problems, not just report them.
Read article →Incident Response
How to respond to production incidents: assess, mitigate, communicate, learn.
Read article →Naming Things
How to name variables, functions, and modules clearly, and the patterns that make code readable.
Read article →On-Call
How to run on-call rotations that don't burn out engineers.
Read article →Postmortems
How to write blameless postmortems that improve systems without punishing individuals.
Read article →Writing Documentation That People Actually Read
How to structure docs for the reader's task, not the writer's mental model.
Read article →Blue-green deployment architecture
Deep-dive on blue-green deployment: two full production environments fronted by a router, deploying and verifying the idle color, atomic cutover and i…
Read article →Canary release architecture
Deep-dive on canary deployments: rollout controllers, weighted traffic routing, fresh-baseline comparison, statistical analysis gates, state and rollb…
Read article →Capacity planning architecture
Deep-dive on capacity planning: forecast, headroom, load testing, provisioning, monitoring, budgets, surge plan, right-sizing.
Read article →Production change management architecture
Deep-dive on production change management: classifying changes by risk, review and approval matched to that risk, staged rollout behind observability …
Read article →Chaos engineering
Deep-dive on chaos engineering: the hypothesis-inject-observe-learn scientific method, failure types (instance, latency, resource, network), blast rad…
Read article →Configuration as code architecture
Deep-dive on configuration as code: a typed source of truth, CI validation gates, per-environment rendering, immutable promotion, secrets references, …
Read article →Deprecation -- retiring things without breaking people
Deep-dive on deprecation: the retirement need, announcing with a timeline and migration path, sunset dates, usage tracking, warnings and nudges (depre…
Read article →Design docs architecture
Deep-dive on the design doc as a decision-making system: why context and non-goals outrank the proposal, honest alternatives, async-first review with …
Read article →Developer Experience Architecture in Depth
A 2500-word walkthrough of DevEx architecture: metrics, feedback loops, local dev, CI latency, environments, documentation, tooling, deployment, suppo…
Read article →Disaster recovery architecture
Deep-dive on disaster recovery: setting RPO and RTO with the business, immutable offsite backups vs cross-region replication, cold/warm/hot standby si…
Read article →Error budget architecture
Deep-dive on error budgets: SLI and SLO foundations, the 1-minus-SLO budget over a rolling window, burn-rate and multi-window multi-burn-rate alerting…
Read article →Feature flag delivery architecture
Deep-dive on feature flag platforms: rule compilation and streaming delivery, microsecond local evaluation with last-known-good fallback, deterministi…
Read article →Game days -- rehearsing failure before it happens
Deep-dive on game days: the untested-recovery-fails premise, the planned failure exercise, realistic scenarios, controlled blast radius, the hypothesi…
Read article →Incident Response Architecture in Depth
A 2500-word walkthrough of incident response: alerts, paging, IC + roles, war room, comms, diagnose + mitigate, timeline, recovery, blameless postmort…
Read article →Incident review architecture
Deep-dive on incident review: blameless postmortem, timeline, contributing factors, action items, follow-through, learning broadcast.
Read article →Launch architecture
Deep-dive on launch architecture: readiness review, feature flags, staged rollout, monitoring, auto rollback, feedback capture, retrospective.
Read article →Load testing architecture
Deep-dive on load testing as an engineering discipline: open vs closed workload models and coordinated omission, the controller/generator/data/telemet…
Read article →Migration architecture
Deep-dive on migration architecture: assessment, waves, strangler façade, dual write/read, cutover, rollback, validation, decommission, and governance…
Read article →Migration playbook architecture
Deep-dive on migration playbook: assessment, waves, strangler façade, dual write, testing, cutover, rollback, comms, retros.
Read article →Oncall architecture
Deep-dive on oncall: rotations, alerts, escalation, runbook, handoff, postmortem, burnout metrics, compensation, alert quality.
Read article →Platform Engineering Architecture in Depth
A 2500-word walkthrough of platform engineering: IDP portal, golden paths, self-service actions, guardrails, service catalog, TechDocs, scorecards, an…
Read article →Release train architecture
Deep-dive on the release train: a fixed-cadence release pattern that fixes the date and flexes the scope. Covers the continuously-releasable trunk, th…
Read article →Rollback Strategy: Architecture Deep-Dive
How to design a fast, rehearsed path back to the last known-good state — traffic switches, retained artifacts, expand/contract schema migrations, and …
Read article →Runbook architecture
Deep-dive on runbooks as a system: anatomy for 3AM execution (trigger, diagnosis tree, actions with blast radius, verification, escalation), the doc-t…
Read article →Secrets management architecture
Deep-dive on secrets management: a central store that issues, protects, rotates, and audits credentials so no human copies a long-lived secret. Covers…
Read article →Service catalog architecture
Deep-dive on the service catalog behind an internal developer portal: the service entity with ownership, dependencies, and metadata; registration-as-c…
Read article →SLO Program Rollout Architecture in Depth
A 2500-word walkthrough of SLO program: leadership sponsorship, tooling, pilots, templates, training, adoption metrics, executive reporting, culture s…
Read article →SLO playbook architecture
Deep-dive on SLO playbook: definitions, error budget policy, review cadence, escalation, comms, postmortem link, roadmap alignment.
Read article →How to Choose a Database
A decision tree that fits on one screen.
Read article →How to Design an API
REST vs gRPC vs GraphQL — fit by use case.
Read article →How to Estimate an Engineering Project
Breaking down work and avoiding the planning fallacy.
Read article →How to Estimate Cloud Cost
Get within 30% before deploying.
Read article →How to Handle Legacy Code
Strangler fig characterization tests and incremental rewrite.
Read article →How to Pick a Log Library
Performance structured output and ecosystem fit.
Read article →How to Pick a TypeScript Runtime
Node vs Bun vs Deno trade-offs in 2026.
Read article →How to Pick an LLM Provider
Beyond the model leaderboards.
Read article →How to Pick a Message Broker
Kafka vs Pulsar vs RabbitMQ vs NATS in 2026.
Read article →How to Review a Design Doc
Questions that catch problems before code.
Read article →How to Review a Pull Request
Substance, style, and what to skip.
Read article →How to Run a Load Test
Realistic profiles tools and what to measure.
Read article →How to Run a Blameless Postmortem
Structure timeline action items and follow-through.
Read article →How to Run an Incident
Roles, channels, and the things people forget.
Read article →Observability from Scratch
What to install on day 1, day 30, day 90.
Read article →How to Write a Design Doc
Sections that matter and the ones that don't.
Read article →How to Write a Runbook
What the page-at-3am operator needs.
Read article →