DEV Community

Cover image for The DevRel Digest August 2024: Choose Your Own Adventure Documentation
Liz Acosta
Liz Acosta

Posted on

The DevRel Digest August 2024: Choose Your Own Adventure Documentation

What a developer wants, what a developer needs

One of the things I love most about my work is crafting content for one of the most discerning audiences out there: developers. They have a low tolerance for bullshit, and honestly, so do I. Maybe it’s my neurodivergence, but I find insincerity difficult to navigate. While that used to be a challenge, I’ve learned to turn it into a strength by embracing my differences and expressing my needs—my real, unapologetic needs.

We’ve recently developed a series of code samples called AI Recipes. Our first recipe was an eye-opening experience in answering a crucial question: What do developers want? More importantly, what do developers need? Just as identifying and addressing my own needs has led to greater personal fulfillment, understanding and meeting developers' needs can empower them to thrive in their roles.

And – real talk – developers who thrive are developers who influence.

Developer Relations: The choose your own adventure era

I believe the era of flashy DevRel demo days is behind us. I’ve been planning to write a follow-up post to this on what “DevRel v2.5” should look like, but let’s be real — I’m not Guy Kawasaki (at least, not yet), so full-time thought leadership will have to wait!

Jonathan Reimer has some good ideas in this post. When it comes to developer-led growth (AKA nurturing influencers), these are the points Reimer emphasizes that I find resonant:

In a wave of nostalgia, I bought used copies of all my favorite Choose Your Own Adventure books. See what happens when you give someone like me adult money? These seemingly childish books have rekindled my love for reading. Why? Because they’re fast, fun, easy, and—best of all—they make me the hero of the story, in control of how the narrative unfolds. Sometimes my endings are triumphant, sometimes they’re tragic, and sometimes they’re totally weird and unnerving. (I’m looking at you, Inside UFO 54-40 – !) It’s low-stakes, low-friction, and fun is guaranteed.

A photo of a collection of 5 Choose Your Own Adventure paperback books: Survival at Sea, The Dragon's Den, The Third Planet from Altair, The Mystery of Chimney Rock, and -- of course -- Inside UFO 54-40

My personal collection of Choose Your Own Adventure books. Tag yourself.

 

DevRel v2.5 is the Choose Your Own Adventure of developer relations. It’s all about self-service. We’ve moved past show-and-tell; now, it’s about guiding developers through their own journey of discovery. After all, you learn best when you’re hands-on. Arriving at that aha! moment by your own volition is one of the best dopamine hits.

Developer education and the developer’s journey

The ultimate dopamine killer? Any piece of developer education content that awakens the beast of imposter syndrome. Once that’s triggered, you’ve lost the developer’s focus.

Developer education includes documentation, tutorials, code samples, and quickstarts. For this post, I watched the Draft.dev recording of their Mastering the Art of Product Documentation & Education webinar for insights from Snyk’s Head of Developer Relations & Community, Randall Degges, and Garrett Frohman, the founder of Mendable.

Here are the parts I found most resonant:

“If developers can’t find the quickstart in the first 15 minutes, they’re probably moving on to something else”

Don’t make developers think—at least not about anything other than the problem they’re trying to solve. If they have to leave your site to understand your product, they’re gonna find the competitor who made content for those keywords.

And to that point, keep it simple and succinct (KISS). This goes for your website, your documentation, and your talks. And how do you keep it simple and succinct?

Assume your audience is starting from scratch

A developer can have years of industry experience and zero experience in your particular technology, so you get the opportunity to teach them. Teaching is a unique relationship that can deeply impact an individual so don’t miss out on the chance to be that person for someone!

In the webinar, Degges recounts how he learned the value of keeping things simple when he gave one of his first talks. In his effort to speak about more advanced and complex topics, he lost his audience.

And if your audience knows more than a beginner, give them the path to more advanced resources. Use chapters and headings to let them choose their own adventure.

Gary Photoshopped poorly as the Hierophant

Gary Photoshopped poorly as the Hierophant. Symbolizing knowledge, teaching, and tradition, the Hierophant speaks to the importance of developer education and the role of content in guiding and instructing. This card reflects the structured, yet insightful approach to teaching and mentoring, aligning with the post’s advocacy for clear, accessible, and well-organized educational resources for developers.

 

Diverse perspectives and voices help make sure all your potential audiences are served appropriately

When you’re the one working on the product, it can be easy to lose sight of how awesome your product is. Your product is cool! And powerful! And solves a problem! So how do you get someone who is completely unfamiliar with the problem space to see that? Diverse perspectives and voices help you challenge your own assumptions.

Frohman talks about this and his company’s experience speaking to different prospects.

“Edutainment” is the future of educational developer content

Degges talks about pivoting their best writers at Synk to producing short educational videos that are as entertaining as they are informative. AI can write pretty well, but it still lacks the warmth and charisma of a personality.

I think this is especially effective when the topics aren’t limited to just the product but also cover concepts and technologies related to the product. Don’t force your developer to look elsewhere for answers to questions like, “What is a dataframe?” Put everything they might need in reach.

A good experience is the key to loyalty and loyalty is the key to evangelism

All of this helps create a positive user experience. As Frohman illustrates in his anecdote about PostHog, making a user feel seen and heard and valued solidifies relationships. The best ad is exactly what Frohman does in the webinar: A peer testimonial.

(Because aren’t you curious now?)

Events and resources and other notable things

Top comments (0)