What Makes for a Good Developer Experience?
There are many elements that contribute to a good developer experience. Obviously, technical aspects such as having a great API, smooth IDE, or clean code play a fundamental part, but let’s look at it through a developer marketing lens.
- Practical Content: It’s stating the obvious, but content must be genuinely helpful and insightful for developers. It should be mapped across the entire developer journey and not just feed the awareness stage or top-of-funnel engagement. When defining and executing their content plan, marketers should think: What problem does this solve? Will developers learn something new? Will it make their lives easier? What stage of the developer journey does it address?
- Multifaceted Resources: Comprehensive technical documentation is not just about having comprehensive content—it’s also about repurposing content into different formats for maximum utilization. For example, a technical document on a new programming technique might also be useful to developers as a how-to video, a technical blog, a GitHub code example, a tutorial, a Jupyter notebook, or even a webinar.
- Clear Signposting: It’s no good having awesome content and resources if developers don’t know where to find them, and the search process is utterly painful. Think about the end-to-end user journey and how developers navigate not just your website but also your document portal and even your GitHub repos. Consider how they search or filter for information and how content should be mapped to lifecycle stages. Provide clear instructions on where developers can go next and why.
- Rapid Onboarding: Developers want to get right into evaluating, building, and testing. Remove any unnecessary manual setup and annoying configurations, and offer them a free trial for frictionless onboarding. This will get developers into your product fast, speed up time to activation, and deliver instant value.
- Community Collaboration: Provide an open and approachable route for developers to ask questions and learn from your internal support teams and SMEs. Support DevRel and foster a community that helps each other through peer-to-peer collaboration and knowledge sharing—whether that’s via Slack, Discord, Reddit or support forums. And, most importantly, listen to the broader community and celebrate their successes.
A good developer experience is about finding the right balance between leaving developers to their own devices (to “try before they buy” without hammering them to death with sales and marketing) and excessive monitoring to identify barriers where they’d benefit from additional resources (like new documentation, one-on-one support, training workshops, or a dedicated program).
In short, it’s about nurturing and accelerating developers through their journey while giving them the creative freedom to explore in their own time.
Which Companies Stand Out With Great DX?
In the AI world, the companies I have to give a shout-out to include Hugging Face for being a leader in open-source collaboration. They give developers easy access to a wide range of (1 million!) ML models and datasets for building applications. Weights & Biases has the ability to integrate model tracking and visualization with just five lines of code, plus they offer Fully Connected, a community enriched with tons of ML resources. And PyTorch—the most popular ML framework—has an extensive ecosystem of tools and libraries, as well as best-in-class developer documentation.
On the marketing side, establishing broader ecosystem partnerships is crucial to enhancing the developer experience. We’ve integrated and collaborated with these leading players because they embrace open-source culture and provide the tools that AI engineers love, contributing to a better experience for our developers.
I’m fortunate to work with hundreds of talented engineers at Graphcore, so I’ve posed this question to them to see who they’d praise for great DX (but not limited to AI).
Solution Architect
“Personally, I’ve found Apple’s iOS developer resources to be quite decent, considering it’s a huge bunch of APIs in a language I wasn’t previously familiar with, i.e., Swift. They have self-contained code examples for every new API feature, and live-coding walkthrough videos from the annual developer conference are published online.”
Graduate Software Engineer
“I have a lot of opinions on this, but without a doubt, the best DX on the planet goes to Vercel. A few things that make it really stand out:
- One-click deployments–it’s as simple as linking up your GitHub repo, and bang, your website is deployed. It’s crazy. You don't need to mess about with configs and they make it easy to get something running on their platform in one click.
- Elite UX/Interface: When you want to find something on the dashboard, it is there and clearly placed next to functionalities that are related to it. The ability to do what you want to do without scouring through documentation is IMO the key to DX.”
Research Team Lead
"VS Code. It just works, but it’s also extensively configurable. It allows you to find out what it's doing in the background. Feels like it doesn't force you into its own framework or too strict a worldview.”
If you compare the last two opinions, one engineer favors the high-level/low-code experience while the other benefits from a low-level/granular code environment that gets under the hood.
This reinforces the importance of understanding your audience and recognizing that it’s not a one-size-fits-all approach. It really depends on the developer's persona—their role, skillset, what tools they use, frustrations, motivations, and ultimately, what they are trying to achieve.
Where Does Developer Marketing End and DX Begin?
Truthfully, developer marketing never stops—it runs in tandem with developer experience. They both support and nurture each other at every step of the developer journey.
At Graphcore, we had to adapt our approach to developer experience and align our marketing efforts to complement a new user journey. When we launched our first-generation product, we were focused on a more traditional sales-led approach by selling on-prem hardware to customers.
Here’s an example of what the developer journey looked like at the time: