API Design Smells

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 […]


Gandalf, still not making sense of your docs

Better API Documentation in 3 Steps

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: […]


Better DevEx for a Better Business

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 […]