While I’ve made a case for Developer Experience (DevEx) – aptly named The Case for a Great Developer Experience – I realized it was making the case to other developers. Obviously developers understand that better docs, a good design, and useful examples make a product easier to use. But how do we quantify that? How […]
API Documentation comes in a variety of forms. You can find it in pdfs, html, or even a Postman-collection that lets you play immediately. You can provide project examples, detailed blog posts, or video walk throughs.There are tradeoffs of each. Regardless of how you deliver the documentation, all documentation fall into one of three buckets: […]
This was originally published on the Clarify.io blog, reproduced here. When I joined Twilio in early 2011, I learned that API companies have three user interfaces: First, there’s the website. It’s what we all think about because it’s the first thing most users see. We have designers, UX people, and similar who spend a lot of […]
Building API helper libraries is hard.
The helper libraries rarely get the same time or attention as the API itself. They’re usually an afterthought.