Engineering Guides

Engineering Guides

How to design APIs, run postmortems, estimate, pick brokers, review PRs.

55Articles
55Topics covered
Articles in this category

All 19 articles, sorted alphabetically

Advertisement
ARTICLE · 01

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
ARTICLE · 02

Canary release architecture

Deep-dive on canary deployments: rollout controllers, weighted traffic routing, fresh-baseline comparison, statistical analysis gates, state and rollb…

Read article
ARTICLE · 03

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
ARTICLE · 04

Chaos engineering

Deep-dive on chaos engineering: the hypothesis-inject-observe-learn scientific method, failure types (instance, latency, resource, network), blast rad…

Read article
ARTICLE · 05

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
ARTICLE · 06

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
ARTICLE · 07

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
ARTICLE · 08

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
ARTICLE · 09

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
ARTICLE · 10

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
ARTICLE · 11

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
ARTICLE · 12

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
ARTICLE · 13

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
ARTICLE · 14

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
ARTICLE · 15

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
ARTICLE · 16

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
ARTICLE · 17

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
ARTICLE · 18

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
ARTICLE · 19

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