The Developer Experience Journey: Exploration

A 5 minute on-stage code-demo beats a slide deck every time
- Developers at every hackathon ever

In my previous post I layed out a framework for understanding developers. In it I provided a way for you to categorize a developer by:

In this article I want to take a deeper look at how a developer can go from unexperienced and unmotivated, to a motivated and experienced developer with all the knowledge and tools they need to be successful on your platform.

The 4 Step Journey

Exploration
Getting Started
Guidance
Reference

A developer experience can be split into a 4 step journey, starting at a level of low motivation and low experience, and slowly building up to full expert level. In this article we will look at how we can help developers make their first step: Exploration.

The art of the 5 minute confidence demo

If you’ve ever seen companies like Twilio present on stage then you know they do a few things very well. One of these is their on-stage demonstration.

Mike Elsmore, then Developer Advocate at IBM doing one of his on stage live code demos.

Mike at Work

Within just 5 minutes they are able to show an interactive demo of their application, using live code and their product in action. They show you their product without you needing to do any coding yourself.

You might think that the most powerful thing here is that Twilio can be integrated in just 5 minutes, but let’s be serious we all know that isn’t true. A real production-ready implementation takes a lot longer than a few minutes to add all the error catching, edge cases, and tests. It would probably take closer to a few days, if not weeks for any reasonably large project.

So why do these 5 minute demos still work so well?

The Ultimate Confidence Boost

Companies like Twilio have mastered the art of giving you the confidence that their product is powerful, useful, and easy enough for you to use. By doing so, they give you a basic understanding of the product and the motivation to try it yourself.

In a few minutes they are able to tell show you:

So how do we translate this magic to an only developer experience?

Exploration documentation

Before: No motivation / No experience
After: Low motivation / No experience

When translate this confidence building to a developer product, a successful exploration of the product should be possible within a few seconds, ideally under 60. This 1-minute comprehension of your product’s capabilities ensures that developers who visit your developer portal will be able to understand:

A good example of this is Twilio’s SMS API demo, where they pair some sample code for sending an SMS side-by-side with a form to send an SMS.

Twilio SMS

These demos are great as they combine code, sample output, and an interactive demo without really requiring the user to do any acctual development. In Twilio’s example I could run the code in my preferred language, but I could also just add my phone number to the form and send a sample SMS.

In both cases, I will have been informed of what Twilio does (the demo), how it does it (the code) and that it’s probably all easy enough for me to understand.

Next

In my next post I will be looking what comes after this exploration phase: Getting Started.

Hire me?

I am a freelance Developer Experience consultant. If you want to know more about my work have a look at my portfolio and if you’d like for me to help improve your company’s Developer Experience then most definitely reach out to me via Twitter or email!


Subscribe to new articles

Updates will be kept to every 2 weeks at a maximum



Related Articles

The 7 Sins of Developer Experience
Friday November 10, 2017
The Documentation Maturity Model
Tuesday May 16, 2017
Developer Onboarding: GitHub
Wednesday April 12, 2017
comments powered by Disqus