I’ve worked for organizations of every size, from being employee #1 to starting at #25 to a massive US federal department. Further, I’d advised companies starting from a single founder to a couple hundred employees. From being on every side of that, one of the things I’m most sensitive to is job title but probably […]
OAuth 2.0 (RFC 6749) is a great authorization framework but it leaves much up to the imagination. Luckily, there are numerous extensions that expand, explain, and clarify the basic capabilities to build a robust and powerful suite of standards. That said, there’s one unobviously complex area which gets little attention: Scopes. What is an OAuth Scope? […]
Building software is hard. You have all the fun of being excruciatingly specific in certain situations, incredibly general the rest of the time, and expressing all of it in a language that isn’t your own. In the context of a new product – whether it’s for a startup or an established company – it’s even […]
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: […]
I’m not a branding strategist. I am not a designer. I came into technical marketing through the backdoor of developer evangelism. In terms of my own approaches to marketing, I have reasonably good instincts but nothing resembling formal training. That said, I know when something is awful. A few years ago, my friend and occasional […]
Recently I had a meeting with an entrepreneur just getting his product off the ground. He has a functional app, a small but active user base, and has been pitching potential customers. He’s talking with his active users regularly and soliciting feedback. By all accounts, he’s doing the right things and moving in the right […]
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 […]