Need someone to lead product or development at your software company? I lead product and engineering teams and I'm looking for my next opportunity. Check out my resume and get in touch.

Developer Experience Principle 5: Easy to Trust

Easy to Trust

Trust is paramount in any relationship between a company and its customers. For developers building their products on top of your APIs, it’s even more so. Your ability to deliver directly affects their product. To feel comfortable with your product, it must be Easy to Trust.

You start building this trust in your marketing. Every communication with the developer needs to be trustworthy and honest, and it starts with how you talk about your product. Developers can be less tolerant of marketing over substance. If you say your product can do something, it needs to do it. Not sort of do it, not do it in the future, not do it if they buy this add-on from a partner. It’s fine to communicate futures and possibilities, but make sure it’s clear what’s available right now.

Everything you communicate needs to be honest and straightforward. You need to be open and transparent with developers. A status page for your API is helpful to developers. You can build trust by showing not just the current state of the API, but historical statistics too. Developers will trust your API more if they can judge for themselves how stable your product is.

Developers need to trust that you’ll do the right thing for their users too. They need to trust you’ll protect their users' data. Believe you won’t put things in your error messages that they can’t show to customers. Know that you understand that their users are your users too.

A great example of this is OAuth permissions screens. An API often has end-users authorize your developer’s applications through your login system. The developer’s application is handing over a part of their user experience to you. How you present the login and permissions can have a giant effect on the conversion rate for your developer. Getting this wrong could scare their users away. When asking for permissions, using confusing or overly-broad names could lead people to abandon signup. Or worse, could lead to people giving permissions that they didn’t realize they’d given up.

A developer is going to build part of their business on your product. They need to believe that you’re going to do the right thing for them and their customers.

More about the Six Principles of Developer Experience

Recently Written

Developer Relations as Developer Success (Oct 19)
Outreach, marketing, and developer evangelism are a part of Developer Relations. But the companies that are most successful with developers spend most of their time on something else.
Developer Experience Principle 6: Easy to Maintain (Oct 17)
Keeping your product Easy to Maintain will improve the lives of your team and your customers. It will help keep your docs up to date. Your SDKs and APIs will be released in sync. Your tooling and overall experience will shine.
Developer Experience Principle 5: Easy to Trust (Oct 9)
A developer building part of their business on your product needs to believe that you're going to do the right thing for them and their customers.
Developer Experience Principle 4: Easy to Get Help (Oct 8)
The faster you can unblock a stuck developer, the better their experience will be.
Developer Experience Principle 3: Easy to Build (Oct 5)
A product makes it Easy to Build by focusing on productivity for developers building real-world applications.
How to understand your product and your market (Sep 30)
A customer development question you can ask to find out who your product is best for and why they'll love it.
Developer Experience Principle 2: Easy to Use (Sep 28)
Making it Easy to Use means letting the developer do everything without involving you.
Developer Experience Principle 1: Easy to Understand (Sep 25)
To create a great developer experience, you must strive for a product that is Easy to Understand. Reduce the amount of thinking that someone needs to do. Make their first encounter with your product clear and easy.


What I'm Reading


Adam Kalsey

+1 916 600 2497


Public Key

© 1999-2020 Adam Kalsey.