As long as developers have been interacting with tools, there's been a "developer experience." And it was usually bad, because writing software is expected to be hard. There was not a widespread …
Use Templates to Create More Developer Content
When Amazon Web Services (AWS) sent an email with their blank template—nothing filled in—the Internet laughed. I took notes. The AWS email included a placeholder image and an inline writing …
Continue Reading about Use Templates to Create More Developer Content →
What Comes After Hello World?
We bought a fancy new can opener, the kind with the squishy handle. When I first held it in my hand, it felt immediately comfortable. The only problem was I couldn't figure out how to open a …
Your API Documentation Checklist
From code reviews to the importance of design, developers disagree on a lot. But what most developers have in common is how quickly they’ll give up on even the best API if its documentation fails to …
Evaluate Your Documentation Like a Developer
When I worked in developer relations, I tried to spend time with the engineers who built our product, in addition to the ones who would use it. Once, one of the team responsible for our developer …
Continue Reading about Evaluate Your Documentation Like a Developer →
How OpenAPI Impacts Developer Experience
The elements of successful developer experience include a lot of context beyond the simple reference of what’s possible. Increasingly, OpenAPI—a specification that defines REST APIs—is used to create …
Continue Reading about How OpenAPI Impacts Developer Experience →