Skip to main content

Communicating state and events in API design

· 18 min read

A status field is a contract. It is also the place where most APIsAPI A set of rules and protocols that allows different software applications to communicate with each other. APIs define the methods and data formats that applications can use to request and exchange information. quietly leak ambiguity, a single word doing the work of three, consumed by people who weren't in the room when you named it. Get it right and an integrator can build correct handling from the payload alone. Get it wrong and they reverse-engineer your intentions from support tickets.

Shakespeare and Dataism

· 2 min read

If perfect knowledge is the theoretical endpoint of human understanding—an omniscient, frictionless clarity—then perhaps its inverse, incomplete information, is the essential condition of drama, comedy, and life itself.

The Bar for AI Keeps Shifting

· 5 min read

During my computer science studies, our introduction to artificial intelligence didn’t begin with neural networks or robotics, but with a parade of definitions:

  • “We call programs intelligent if they exhibit behaviors that would be regarded intelligent if they were exhibited by human beings.” — Herbert Simon

Maybe I'll send an email once in a while

Monthly digest. No spam.