Skip to main content

15 posts tagged with "design"

View All Tags

Adding a links field to API responses

· 2 min read

We added a links field to our APIAPI 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. response objects this week. Small change, and I'd put it off for a while because it felt like ceremony. It isn't.

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.

Imperfect AI is perfect

· 3 min read

In a recent piece, I made the case that we should stop trying to build "perfect" AI. That imperfection is not a failure mode — it's intrinsic to how these systems work. Here, I want to go one step further: not just to excuse AI's flaws, but to explore how we can use them. How we can design with imperfection in mind.

Designing a consistent error handling pattern for APIs

· 8 min read

Errors and warnings are a minefield for developers, and very inconsistently implemented across 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.. I've been thinking about what a consistent, developer-friendly approach to surfacing issues looks like, one that helps both developers and their end users.

This is focused on APIAPI 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. responses and logs rather than native SDKsSDK A collection of software development tools, libraries, documentation, code samples, and guides that help developers create applications for a specific platform or framework..

Stop abbreviating in your APIs

· One min read

A small plea: stop abbreviating field and method names in your 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., SDKsSDK A collection of software development tools, libraries, documentation, code samples, and guides that help developers create applications for a specific platform or framework., and config.

Hand Typed

· 5 min read

A collection of hand-typed letterforms and numbers, each with their own character and texture. These were created using various materials and techniques, from traditional pen and paper to more experimental surfaces.

How important was postage stamp propaganda in the establishment of Soviet Russia?

· 9 min read

Since the introduction of the Penny Black in 1840, the postage stamp has been used as a prominent canvas for pushing political and cultural agendas. Stamps have frequently been adorned with the faces of monarchs and other political leaders. Other common subjects include cultural landmarks, key historic figures of the nation, and nationalistic imagery. In this essay, I will investigate the role of Russia’s stamps in the establishment of the Soviet Union and communist political and social ideals.

Maybe I'll send an email once in a while

Monthly digest. No spam.