DevRel Playbook

How do I get into DevRel?

Work through five phases, in order. Start by understanding what Developer Relations is and building a technical baseline. Then learn the four core skills, build visibility, get involved in open source and grow into strategy and leadership. Every topic has a lesson, and every skill module follows Learn → Resources → Challenge.

5 phases11 skill modules93 lessonsSee it on the career map →
Your progress through the library0%
0 of 104 steps · 0 of 11 Compass Challenges complete
Phase 01 of 5

Foundation

Prepares you for: Getting in: aspiring → Junior DevRel · 3–4 weeks at 5 hours a week

Understand what DevRel is, where it sits in an organization, and build the technical baseline every practitioner needs regardless of background.

Read the context for this phase

Developer Relations sits between a company and the developers who use its product. Developers trust other developers, not ads, so a company that wants developers to adopt its API, SDK, database or platform needs people who can teach, build and listen in public. That is the job.

The simplest working definition comes from Mary Thengvall: DevRel is the umbrella term for the strategies and tactics that build relationships with developers. The relationship runs both ways. You bring the product to developers through content, talks, docs and community. You also bring developers back to the company, turning their friction, feature requests and bug reports into signal that product and engineering can act on. The second half is the one beginners forget, and it is what separates DevRel from promotion.

This phase gives you two foundations:

  1. A clear model of the function. Where it came from, the roles inside it, why companies pay for it, and how the org chart changes what "good" looks like. Without this you will say yes to everything and get measured on the wrong things.
  2. A technical baseline. You don't need to be a staff engineer, but you do need to build a working demo, read someone else's code, open a pull request and talk about deployment without bluffing. Developers notice immediately when someone doesn't really get it, and credibility is the currency of this whole career.

If you come from engineering, the first module will be new and the second will be review. If you come from marketing, writing or community work, it's the other way round. Either way, finish both before moving on. Every later phase assumes them.

By the end of this phase you'll be able to
  • Explain what Developer Relations is, why companies fund it, and how it differs from marketing
  • Name the main DevRel roles and pick the one that fits your background
  • Describe how reporting lines shape what a DevRel team is measured on
  • Build and explain a small demo against a real API, using Git and GitHub like a working developer
  • Speak credibly about cloud deployment, issue tracking, and the tools your audience uses every day

What is Developer Relations, and why do companies pay for it?

0/7 topics
  1. History & Evolution of DevRelHow the role emerged from engineering and marketing, key milestones from Sun Microsystems to CNCF.
  2. Types of DevRel RolesDeveloper Advocate, Developer Relations, Developer Education, Technical Writer, Developer Marketing, Community Manager and Developer Experience — what each job involves, how it is measured and how they differ.
  3. Where DevRel Practitioners Come FromThe five common backgrounds people move into DevRel from, the strengths each brings, and the gaps to close.
  4. Importance of DevRelWhy organizations invest in DevRel and how it drives developer adoption, retention, and product feedback.
  5. The DevRel MindsetCommunity-first thinking, long-term relationship building, and authentic representation.
  6. DevRel vs Developer MarketingUnderstanding the overlap, the distinctions, and how they work together effectively.
  7. DevRel in Different Org StructuresDevRel under Product, Marketing, Engineering — how reporting lines shape priorities.
🧭 Challenge: Write your DevRel manifestoStart module →

How technical do I need to be to be credible with developers?

0/6 topics
  1. Basic Programming SkillsAt least one language deeply enough to build demos, read others' code, and debug integrations.
  2. APIs & SDKsUnderstanding REST, GraphQL, webhooks, and how SDKs abstract them. Ability to use and explain APIs credibly.
  3. Git & GitHubVersion control basics, branching, pull requests, issues — the language of open source collaboration.
  4. IDEs & Developer ToolsVS Code, JetBrains, terminal workflows — being genuinely comfortable in a developer environment.
  5. Issue Tracking SystemsGitHub Issues, Jira, Linear — triaging, labelling, and managing community-reported bugs.
  6. Cloud & Infrastructure BasicsEnough AWS/GCP/Azure to understand deployment, containers, and developer pain in production.
🧭 Challenge: Ship a "Hello World" demo developers can run in 5 minutesStart module →
Open the Phase 01 overview →
Phase 02 of 5

The Four Core Pillars

Prepares you for: Junior DevRel · 8–12 weeks at 5 hours a week

The four disciplines that define DevRel work at every level. Most practitioners specialize in one or two early on, then expand coverage with experience. All four are required for senior roles.

Read the context for this phase

Phase 1 gave you the why and the technical baseline. Phase 2 is the what: the four disciplines that make up day-to-day DevRel work.

  • Content Creation teaches at scale: tutorials, docs, samples, video.
  • Community Building creates a place where developers help each other and help shape the product.
  • Public Speaking & Events builds trust fast, one room at a time.
  • Developer Experience removes the friction that makes developers quit.

They reinforce each other. A talk becomes a blog post, which becomes a docs page, which answers a community question, which reveals a DX problem, which becomes a product fix, which becomes your next talk. That loop is DevRel. The better you understand it, the more each piece of work compounds.

You don't need to master all four at once. Most practitioners go deep in one or two early in their career. Engineers often lead with content and DX, and community builders with community and events. Aim for working competence in all four before moving to senior roles. Each module ends with a Compass Challenge that produces a real, public portfolio piece. Do them: a portfolio of four challenge outputs is a strong DevRel application on its own.

By the end of this phase you'll be able to
  • Plan, write and publish technical content that solves real problems — and measure it
  • Launch, run and grow a developer community with healthy norms and metrics
  • Pitch, build and deliver technical talks and workshops, including live demos
  • Map a developer journey, measure onboarding friction and turn feedback into product change

What makes technical content effective, and how do you produce it consistently?

0/11 topics
  1. Content StrategyAudience identification, content calendar, distribution channels, and goal alignment with business outcomes.
  2. Blog Posts & TutorialsLong-form technical writing that educates developers — from getting started guides to deep-dives.
  3. DocumentationGetting Started guides, API references, FAQs — the backbone of developer experience at scale.
  4. Code Samples & Example AppsRunnable, well-commented code that shows real-world usage patterns developers can copy-paste and build on.
  5. Video & Live StreamingDemos, walkthroughs, and live coding sessions — YouTube, Twitch, and community platforms.
  6. Podcasts & AudioInterviews, discussions, and educational audio for developer audiences on the move.
  7. NewslettersRegular digests that keep your community informed, engaged, and returning.
  8. Editing & Brand VoiceWriting concisely, with personality — building a consistent voice across all output formats.
  9. Content Performance AnalysisMeasuring reach, engagement, and downstream conversion from every content asset you ship.
  10. Guest BloggingWriting for external publications (dev.to, Smashing Magazine, InfoQ) to reach new audiences.
  11. Animations & Visual ExplainersDiagrams, motion graphics, and visual content that explains complex concepts faster than text.
🧭 Challenge: Publish your first technical tutorialStart module →

How do you build a developer community people actually want to be part of?

0/10 topics
  1. Building a Community from ScratchChoosing platforms, seeding activity, onboarding early members, and creating the culture from day one.
  2. Community ManagementDay-to-day moderation, health monitoring, member support, and keeping energy high.
  3. Community Guidelines & Code of ConductSetting expectations, enforcing rules consistently, and creating psychologically safe spaces.
  4. Forums & Discussion PlatformsDiscord, Slack, Discourse, Reddit, GitHub Discussions — where developers actually gather and talk.
  5. Meetups & Local EventsOrganizing, promoting, and facilitating in-person and virtual gatherings around your community.
  6. Encouraging ParticipationRecognition programs, contributor spotlights, first-contribution guides, and engagement loops.
  7. Managing Difficult Members & ConflictHandling disputes with empathy and clarity while protecting community culture.
  8. Community Growth StrategiesAcquisition tactics, referral programs, cross-community partnerships, and ambassador programs.
  9. Community Health MetricsDAU/MAU, retention, message volume, contributor growth — measuring vitality not just size.
  10. Onboarding New MembersWelcome flows, starter resources, and quick-win paths that turn lurkers into active contributors.
🧭 Challenge: Design a community launch planStart module →

How do you give technical talks and run events that people remember?

0/11 topics
  1. CFP Writing & Talk ProposalsHow to pitch compelling talks — abstract writing, title selection, speaker bio strategy.
  2. Talk Structure & NarrativeBuilding a story arc: hook, premise, demonstrations, takeaways. Making technical content memorable.
  3. Live Demo DeliveryRunning demos that don't break — rehearsal strategy, fallback plans, and recovery skills.
  4. Conference SpeakingTier-1 events (KubeCon, AWS re:Invent, DevRelCon, Open Source Summit) — norms and expectations.
  5. Meetup & Lightning TalksLower-stakes stages to build confidence, gather feedback, and refine material fast.
  6. Engaging Your AudienceStorytelling techniques, audience interaction, pacing, and energy management for long sessions.
  7. Handling Q&AAnticipating tough questions, bridging to your message, and managing what you don't know.
  8. Workshop FacilitationHands-on sessions that teach by doing — curriculum design, pacing, and participant support.
  9. Event ManagementRunning your own events — logistics, promotion, sponsorship, and post-event follow-up.
  10. Media AppearancesPodcast guest appearances, webinar panels, press interviews — representing your company or project publicly.
  11. Handouts & Supporting MaterialsSlide design, code repositories, resource lists — materials that extend the value of a talk.
🧭 Challenge: Submit your first CFPStart module →

How do you find and remove the friction developers hit with your product?

0/9 topics
  1. Developer Journey MappingCharting every touchpoint from discovery through onboarding to advanced production usage.
  2. Onboarding & Time-to-Hello-WorldReducing friction from sign-up to first successful API call — the single most critical DX metric.
  3. Developer Satisfaction MeasurementCSAT surveys, NPS, qualitative interviews — understanding how developers actually feel.
  4. Feedback Collection at ScaleStructured surveys, community listening, support ticket analysis, and one-on-one interviews.
  5. Feedback Loop to Product & EngineeringSynthesizing developer pain into structured, prioritized product recommendations engineering can act on.
  6. Building & Contributing to SDKsReducing integration friction by contributing to client libraries across major languages.
  7. Documentation as a ProductTreating docs as a living product — versioned, tested, and iterated based on developer usage patterns.
  8. DX AuditsSystematic review of a platform's developer experience from a fresh set of eyes.
  9. Error Messages & Edge CasesMaking failures clear, actionable, and non-frustrating — the DX of things going wrong.
🧭 Challenge: Publish a DX auditStart module →
Open the Phase 02 overview →
Phase 03 of 5

Visibility & Growth

Prepares you for: Mid-Level DevRel · 4–6 weeks at 5 hours a week

Build your personal brand as a practitioner and use data to measure, justify, and scale your work's impact on the business.

Read the context for this phase

Two things decide whether a DevRel career grows: whether people know your work and whether you can prove it matters. This phase covers both.

Personal brand isn't vanity. In DevRel your reputation is part of the job. Developers listen to people they recognise and trust, event organisers invite speakers they've seen, and hiring managers shortlist candidates whose work they've already read. As Adora Nwodo says in her Strategy Room session, visibility doesn't mean hundreds of thousands of followers. It means being known for something specific by the right people.

Analytics is the other half. DevRel teams without numbers get cut; DevRel teams with only vanity numbers get misunderstood. You'll learn to separate signal from noise, report in the language of business outcomes and use data to decide what to stop doing.

Treat these as one system: the same habits of consistency, clarity and reflection power both.

By the end of this phase you'll be able to
  • Define a clear personal positioning and voice, and show up consistently without burning out
  • Use LinkedIn, X and visual platforms deliberately, each for what it does best
  • Choose DevRel metrics that signal real impact instead of vanity
  • Build a simple reporting cadence that tells leadership the story of your work

How do you become known for something — without becoming an influencer?

0/8 topics
  1. Building a Personal BrandYour unique POV, area of expertise, and consistent presence — being known for something specific.
  2. Creating Your Brand VoiceTone, style, and personality that resonates authentically with developer audiences.
  3. LinkedIn StrategyProfessional presence, long-form thought leadership, company representation, and career visibility.
  4. Twitter / X StrategyReal-time developer engagement, thread-based education, and community interaction at speed.
  5. Consistent Publishing CadenceContent scheduling, batching, and systems for showing up regularly without burning out.
  6. Cross-Platform PromotionAmplifying content across platforms, repurposing formats, and collaborating with other creators.
  7. Building in PublicSharing your work, learnings, and process openly — one of the most powerful DevRel growth strategies.
  8. Instagram for DevRelVisual storytelling for events, behind-the-scenes, community highlights, and conference coverage.
🧭 Challenge: Build in public for 30 daysStart module →

How do you prove that DevRel work matters?

0/8 topics
  1. Key DevRel MetricsCommunity size, activation rate, content reach, talk attendance, developer NPS — the core dashboard.
  2. Vanity vs Signal MetricsDistinguishing followers and views from indicators of real developer engagement and adoption.
  3. Content Performance TrackingPage views, bounce rate, time on page, and conversion to sign-up — content ROI.
  4. Community Health AnalyticsMessage frequency, new member activation, churn rate, and contributor-to-lurker ratio.
  5. Data Visualization for LeadershipPresenting DevRel metrics to executives in a way that connects to business outcomes.
  6. Google Analytics & Product AnalyticsGA4, Amplitude, Mixpanel — tracking developer behavior from docs to sign-up to production.
  7. Data-Driven IterationUsing data to kill underperforming programs, double down on what works, and justify new investments.
  8. Reporting CadenceWeekly/monthly/quarterly DevRel reports — telling the story of your work to stakeholders.
🧭 Challenge: Create a DevRel impact reportStart module →
Open the Phase 03 overview →
Phase 04 of 5

Open Source

Prepares you for: Mid-Level → Senior DevRel · 4–6 weeks at 5 hours a week

Open source is the cultural substrate of developer communities. Understanding and participating in it is non-negotiable for effective DevRel at any level.

Read the context for this phase

Open source is where developers learn, collaborate and build their reputations. Most modern software depends on it, and many developer communities form around it. For DevRel, open source is both a skill (contributing, maintaining) and a strategy (using openness to build trust, adoption and community).

Nadia Eghbal's Working in Public describes an important shift: many popular projects now have large numbers of users but very few maintainers. The bottleneck isn't contributions; it's maintainer attention. Good DevRel in open source makes maintainers' lives easier. It triages, documents, onboards contributors well and never floods projects with low-effort PRs.

This phase covers the full picture, from your first pull request to company open source strategy, governance and licensing.

By the end of this phase you'll be able to
  • Make meaningful contributions to open source projects — code, docs and triage
  • Maintain a healthy repository: issues, labels, good first issues and reviews
  • Explain common governance models and open source licenses to developers and colleagues
  • Advise on when and how a company should open source something — and how to sustain it
Open the Phase 04 overview →
Phase 05 of 5

Advanced DevRel

Prepares you for: Senior, Staff & DevRel Leader · Ongoing — 6+ weeks, then continuous practice

Strategic, leadership, and cross-functional capabilities that define senior, staff, and leadership-level practitioners. This is where DevRel becomes a business function, not just a role.

Read the context for this phase

Senior DevRel is less about doing more talks and more about designing systems that create outcomes. At this level you're expected to set strategy, justify investment, work across the company and grow other people.

Two ideas run through this phase:

  1. DevRel is a business function. Your programs exist to serve company goals, adoption, retention and product quality, in ways only DevRel can. You'll learn to set goals leadership understands and to show progress against them.
  2. Leverage over effort. You can't personally talk to every developer. Senior practitioners multiply impact through programs (champions, education), systems (feedback loops, content engines) and people (hiring, mentoring).

Watch Rohit Ghumare's Strategy Room session on systems thinking and Linda Ikechukwu's session on turning developer education into business outcomes. Together they frame this whole phase.

By the end of this phase you'll be able to
  • Align DevRel programs with marketing goals without losing developer trust
  • Design a DevRel program from zero: mission, metrics, team, budget
  • Set DevRel OKRs that connect community health to business outcomes
  • Influence product, engineering, marketing and sales without authority
  • Hire, grow and lead DevRel practitioners, and build advocacy programs that scale
Module 1optional

Developer Marketing

How do you grow adoption through marketing that developers actually trust?

0/5 topics
  1. Developer Marketing StrategyAligning DevRel programs with marketing goals — awareness, acquisition, activation, retention.
  2. Initial Outreach & PartnershipsCold outreach to potential community members, integration partners, and co-marketing collaborators.
  3. Collaborations & Co-MarketingJoint content, events, and promotions with complementary tools, platforms, or creators.
  4. Education & Certification ProgramsStructured learning paths, certifications, and workshops that drive deep product adoption at scale.
  5. Developer Advocacy as a Growth ChannelMeasuring and attributing developer program contributions to sign-up, conversion, and revenue.
🧭 Challenge: Design a developer education pathStart module →

How do you build, lead and scale a DevRel function?

0/9 topics
  1. Building a DevRel ProgramMission, metrics, team structure, budget — building the function from zero with executive buy-in.
  2. DevRel OKRs & Goal SettingSetting ambitious, measurable goals that connect community health to business outcomes.
  3. Insights & RecommendationsTurning developer and community data into structured, executive-ready product recommendations.
  4. Cross-functional CollaborationWorking with Product, Engineering, Marketing, Sales — influence without authority at scale.
  5. Hiring & Building a DevRel TeamWriting JDs, interviewing, onboarding DevRel hires, and developing junior practitioners.
  6. Execution & PrioritizationRuthless prioritization, shipping consistently, managing stakeholder expectations across functions.
  7. Continuous Learning & Trend TrackingStaying current across technology, community trends, and the DevRel function itself.
  8. Active Listening & Community SensingReading the room at conferences and in communities — translating sentiment into strategic signal.
  9. Advocacy ProgramsChampion, ambassador, and MVP programs that turn super-users into an extension of your DevRel team.
🧭 Challenge: Write a DevRel strategy for a companyStart module →
Open the Phase 05 overview →