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.
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.
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.
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?
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:
That Twilio is easy to use
So how do we translate this magic to an only developer 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.
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.
In my next post I will be looking what comes after this exploration phase: Getting Started.
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!