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 →
Innovative Developer Tutorial Interfaces
You can probably imagine yourself midway through a complex technical tutorial. You have multiple terminal windows open. Your browser has tabs aplenty. Your fingers have memorized the “Ctrl-F” pattern …
Continue Reading about Innovative Developer Tutorial Interfaces →
Your Developer Experience is Made of Content
Physical places have a collection of characteristics that make your experience. There are visual and audio cues that make up an ambiance. There are signs and design elements that point you to a …
Continue Reading about Your Developer Experience is Made of Content →
Build a Technical Editorial Calendar You Will Actually Use
A consistent drum beat of content is a healthy sign of a developer tool. It shows that you’re not just building, but that you’re also thinking about how people use your software. Your content can grab …
Continue Reading about Build a Technical Editorial Calendar You Will Actually Use →