In software development, a “Design Smell” is a signal that something isn’t quite right. Think of it like your car sounding a little bit different or your Spidey Sense tingling. In the best of times, you can immediately point at the problem and know how to fix it. But the rest of the time, it […]
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: […]
All opinions and analysis in this post reflect my experience and opinion, not those of current or previous employers. They did not review or approve of this in any form. For years I’ve advised everyone from solo developers to Fortune 50 companies on the best approaches to designing and building APIs in addition to numerous […]