api-design – Page 14 – Türker Yıldırım

A postmortem without an owner is a document

NoteAugust 25, 20212 min read

The value of a postmortem is entirely in the actions, and an action without a name and a date is a wish. Reviewing the action list from the…

Escalating is not failing, and the runbook should say so

NoteAugust 6, 20212 min read

A rotation where asking for help feels like failure produces two hours of struggling on something the expert fixes in ten minutes. Putting it in writing, in every…

A CSV export that streams instead of collapsing

Deep diveJuly 29, 202110 min read

An export that worked until the account with 400,000 rows. fetchAll, a collection and a string built in memory, at 512 MB.

theme.json is a contract between a theme and the editor

Deep diveJuly 5, 202110 min read

5.8 in July, and a settings file that replaces a hundred lines of add_theme_support plus a stylesheet arguing with the editor.

An idempotency key comes from the client or not at all

NoteJune 17, 20211 min read

The server cannot tell two identical requests apart from one request sent twice, because the payload is the same either way — only the client knows which it…

A webhook endpoint that survives the sender

Deep diveJune 2, 202110 min read

The payment provider retried for six hours and every attempt timed out. A webhook is a notification, not a request for processing.

Terraform 1.0 is a promise about the next five years

Deep diveJune 2, 202110 min read

A version number that is a compatibility statement rather than a feature list. Three environments described by hand, and the import that is most of the work.

Cursor pagination, and the offset that skips rows

NoteMay 19, 20211 min read

Offset pagination over a list that changes between requests skips and duplicates rows, and it gets slower as the offset grows. The row-skipping is the correctness argument and…

Compose v2 is a plugin, and the hyphen finally goes

Deep diveMay 19, 20219 min read

The same command, spelled two ways, on eight machines. A Python program became a Go plugin, and the container names changed underneath every script.

The service that should not have been a service

Deep diveMay 14, 202110 min read

Four services, three of which deploy together and share a database. The costs of distribution with none of the independence.