Skip to main content

40 posts tagged with "engineering"

View All Tags

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 (Application Programming Interface). 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 (Application Programming Interface). 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 (Software Development Kit). A collection of software development tools, libraries, documentation, code samples, and guides that help developers create applications for a specific platform or framework..

Prioritizing the small things

· 2 min read

Prioritization has a structural problem. If every piece of work competes in the same backlog, large, high-impact projects will always beat small improvements. That's usually the right outcome for each decision, but the wrong outcome for the product over time.

Minor bugs, inconsistent spacing, awkward copy, and other small flaws rarely become important enough to win on their own. So they linger.

Stop abbreviating in your APIs

· One min read

A small plea: stop abbreviating field and method names in your APIsAPI (Application Programming Interface). 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 (Software Development Kit). 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.

Maybe I'll send an email once in a while

Monthly digest. No spam.