Skip to main content

DevRel is a business function

Living handbook

This is a working field guide. The ideas will sharpen as the practice changes and as better examples emerge.

Developer Relations has a reputation for being squishy.

That reputation is understandable. DevRel work often shows up as talks, docs, demos, community conversations, feedback threads, samples, videos, events, and hallway conversations. From the outside it can look like a grab bag of helpful activity. From the inside it can feel hard to explain because the work touches product, engineering, marketing, support, sales, and community without belonging neatly to any one of them.

This handbook starts from a different premise: DevRel is a structured business function.

DevRel helps an organization understand developers, improve the technology those developers use, and create the conditions for a healthy developer ecosystem. The work can be creative, relational, and hard to reduce to a single metric, but that does not make it vague. It means the operating model needs to be clear.

The purpose of this handbook is to name that operating model.

The core thesis

DevRel turns developer signal into business action.

Signal comes from the field: what developers are trying to build, where they get stuck, what they misunderstand, what they love, what they distrust, and what they need next. Business action is what the organization does with that signal: clearer content, better product decisions, stronger communities, sharper positioning, healthier feedback loops, and more useful technology.

When DevRel works, the organization learns faster and developers succeed sooner.

That is the thread that connects the rest of this book.

Who this is for

This handbook is for people who already have a DevRel practice, people who are building one, and people who keep asking why the work matters.

It is especially for teams that build technology for developers. If developers need to understand your platform, trust your roadmap, give you feedback, join your community, or bet part of their own work on your tools, then DevRel is not decoration. It is part of how the business learns and earns trust.

The questions this book tries to answer are practical:

  1. What business purpose does DevRel serve?
  2. What work should DevRel teams do, and what should they avoid?
  3. How does DevRel create content, refine technology, and grow community?
  4. How should the work be measured?
  5. How should a DevRel team be structured so the practice can scale?

About Me

I have worked in DevRel for more than a decade: first as a Technical Evangelist, then as a Program Manager, and now as a Developer Advocate. My background is in computer science and machine learning, but I have also spent meaningful time teaching in high school and college settings.

That intersection of technology and teaching is what drew me to DevRel. Developers want to solve real problems and create value for the people who use their work. The best DevRel teams respect that ambition. They help developers move faster while helping the organization build technology worth adopting.

Disclaimer

These are my thoughts. They may or may not represent the views of my current or previous employers.

The shape of the book

The handbook is organized like a field guide. Read it front to back if you are designing a DevRel practice from scratch, or jump to the chapter that matches the problem in front of you.

PartWhat it answersChapters
FoundationsWhy DevRel exists and what principles make the work coherent.Business Purpose, Creating a Mission, Working from Principles
The operating loopWhat DevRel teams do week after week.Create Content, Refine Technology, Grow Community
Making it runHow the practice proves value and scales.Measuring Success, Structuring the Team
Authoring toolsHow this handbook is written and extended.Authoring Diagrams, Handbook Components

The recurring concepts are simple:

  1. Create content that helps developers understand and act.
  2. Refine technology by bringing field signal back into the product.
  3. Grow community through trust, contribution, and shared learning.
  4. Measure success by connecting activity to developer and business outcomes.
  5. Structure the team so the work is repeatable instead of heroic.

Start with why

The first question is not "What should DevRel publish?" or "Which events should we sponsor?"

The first question is: what business purpose does DevRel serve?

Answer that clearly and the rest of the work has a place to stand.