> Markdown version of [/videos/1120-diving-into-developer-experience](https://www.wearedevelopers.com/videos/1120-diving-into-developer-experience). Every page supports `.md` or `Accept: text/markdown`. Links point to the HTML versions so they work for humans too. Agent guide: [/agents.md](https://www.wearedevelopers.com/agents.md).

---

# Diving into Developer Experience

An exceptional developer experience relies on predictability, not magic. Discover how a docs-first approach treats documentation as architectural wireframes, transforming frustrating APIs into seamlessly adopted platforms.

- **Speakers:** [Ricky Holtz](https://www.wearedevelopers.com/@ricky-holtz)
- **Event:** World Congress 2024
- **Published:** August 20, 2024
- **Duration:** 20:16
- **URL:** https://www.wearedevelopers.com/videos/1120-diving-into-developer-experience

## Summary

As developers increasingly dictate software purchasing decisions, delivering an exceptional developer experience (DX) is no longer an optional luxury. The modern definition of a developer has actively broadened beyond traditional software engineers to include data scientists, marketers, and no-code builders stringing workflows together. To serve this diverse audience, technical products must map directly to realistic user expectations across the entire workflow—from initial discovery to long-term code maintenance. Product builders can no longer rely on power users stomaching fragmented, frustrating API interactions or empty command-line screens. Instead, evaluating API usability requires recognizing the "developer cognitive journey." Builders typically seek an overarching solution fit to their specific business problem before digging into the granular methods and parameters of a tool. 

Navigating this cognitive journey means anchored development shouldn't exclusively strive for continuous "magic." In the spectrum of platform friction, transitioning from a broken interface to a highly "predictable" experience is in itself a massive achievement for technical integrations. Cross-functional DX reviews that gather frontline empathy from sales and support teams help align product intent with these baseline expectations. One of the highest-leverage strategies to realize this alignment is docs-first design. By writing the technical documentation before coding an API, product managers treat guides as architectural wireframes, preventing the common trap of merely shipping raw database schemas to end-users. 

Iterating further, teams can leverage open-source tooling to deploy low-stakes interface prototypes, allowing the community to test resources like CLI simulators before native console components are officially integrated. Supported by quantitative indicators like Net Promoter Scores and demographic trend analyses, these intent-rich feedback loops continuously inform product iteration. Ultimately, prioritizing use-case based onboarding flows over blank sandbox environments ensures that an API feels highly contextualized, accelerating developer success and cementing long-term platform adoption.

**Keywords:** developer experience frameworks, api documentation design, docs-first workflow methodology, developer cognitive journey, api usability best practices, developer advocacy strategies, open-source platform prototyping, use-case based onboarding, no-code developer tooling, cross-functional dx reviews, net promoter score tracking, platform ux design, developer relations metrics, software purchasing influence, cli tool development

## Chapters

1. **The rising influence of developers in purchasing decisions** (00:05) — How the shift from hardware to software positioning makes developers critical platform stakeholders.
1. **Recognizing the frustration caused by poor developer experiences** (02:00) — The historical acceptance of lackluster tooling highlights the need for modernized technical interfaces.
1. **Broadening the definition of a developer across roles** (03:52) — Expanding the view of makers to include data scientists, marketers, and no-code builders.
1. **Defining developer experience through builder expectations and workflows** (05:38) — Structuring tools to accurately align with user problem-solving goals and technical discovery paths.
1. **Mapping tools along the developer experience quality spectrum** (07:14) — Assessing technical platforms from broken to magical, recognizing the immense value of predictable utility.
1. **Navigating the developer cognitive journey toward solution fit** (09:28) — Prioritizing correct solution alignment before introducing specific technical methods and API parameters.
1. **Collecting product insights through reliable developer data sources** (11:39) — Tracking metrics like net promoter score and survey demographics paints an accurate industry picture.
1. **Validating product utility using a docs-first design strategy** (14:37) — Drafting product documentation before writing code acts as a functional wireframe for developers.
1. **Testing new capabilities rapidly with open-source community experiments** (16:02) — Deploying community-driven applications provides low-risk environments to refine future enterprise platform capabilities.
1. **Improving platform onboarding with internal developer experience reviews** (17:40) — Sourcing frontline insights from sales and support streamlines targeted, use-case driven account configurations.
1. **Starting the development process with empathy and understanding** (18:59) — Applying design thinking logic ensures internal teams remain focused on genuine user pain points.

## Related Moments

- [Pioneering the concept of developer experience](https://www.wearedevelopers.com/videos/919-coffee-with-developers-adam-wiggins) (from "Coffee with Developers - Adam Wiggins")
- [Integrating developer docs and product experiences seamlessly](https://www.wearedevelopers.com/videos/1986-one-developer-journey-two-surfaces) (from "One Developer Journey, Two Surfaces")
- [Transitioning from enterprise software to developer experience focus](https://www.wearedevelopers.com/videos/727-the-abc-of-dx) (from "The ABC of DX")
- [Defining developer experience functions within modern engineering teams](https://www.wearedevelopers.com/videos/546-securing-secrets-in-the-gitops-era) (from "Securing Secrets in the GitOps era")
- [Identifying the four core pillars of developer experience](https://www.wearedevelopers.com/videos/727-the-abc-of-dx) (from "The ABC of DX")
- [Summarizing the current state of developer experience](https://www.wearedevelopers.com/videos/1698-state-of-devex-2025-navigating-the-ai-revolution-and-developer-experience) (from "State of DevEx 2025: Navigating the AI Revolution and Developer Experience")

## Related Articles

- [Why developer experience matters](https://www.wearedevelopers.com/magazine/514-why-developer-experience-matters)
- [Humanizing Your Documentation](https://www.wearedevelopers.com/magazine/133-humanizing-your-documentation)
- [The real reason we document our code](https://www.wearedevelopers.com/magazine/518-the-real-reason-we-document-our-code)
- [Events like RSAC Get You CISOs. Developers Decide What Actually Gets Deployed.](https://www.wearedevelopers.com/magazine/693-events-like-rsac-get-you-cisos-developers-decide-what-actually-gets-deployed)

## Related Jobs

- [Principal Software Engineer, Enterprise AI Platform](https://www.wearedevelopers.com/jobs/ext/1467292-principal-software-engineer-enterprise-ai-platform) at **GitHub**
- [Principal Product Manager, Agent Platform](https://www.wearedevelopers.com/jobs/ext/277541-principal-product-manager-agent-platform) at **GitHub**
- [Tribe Lead - ( Software) Engineering Centre of Excllence](https://www.wearedevelopers.com/jobs/ext/1475530-tribe-lead-software-engineering-centre-of-excllence) at **SD Worx**
- [Senior Software Engineer, Client Apps Platform](https://www.wearedevelopers.com/jobs/ext/1773893-senior-software-engineer-client-apps-platform) at **GitHub**
- [Staff Software Engineer, Copilot Experiences](https://www.wearedevelopers.com/jobs/ext/164361-staff-software-engineer-copilot-experiences) at **GitHub**
- [Principal Software Engineer, Database Infrastructure](https://www.wearedevelopers.com/jobs/ext/1465908-principal-software-engineer-database-infrastructure) at **GitHub**