Reference

Developer
Marketing.

A practitioner-written pillar reference on developer marketing: the five channels that work, the four common mistakes, how it differs from enterprise B2B marketing, and why most DevTools companies are getting it wrong. Built from 12 years inside developer-first companies including JetBrains, Lightrun, and Odigos.

By Daria Dovzhikova · Updated May 2026

TL;DR

  • Developer marketing sells to the hands-on developer, not the economic buyer — so working code, docs, and OSS replace demo decks, analyst relations, and gated white papers.
  • Five channels actually move adoption: documentation, open source, technical content, developer community, and integration partnerships.
  • The recurring failures are predictable: hiring enterprise PMM by default, treating docs as engineering output, optimizing for demos booked, and broadcasting into communities instead of contributing.

What developer marketing actually is

Developer marketing is the discipline of building trust and adoption with developer audiences through documentation, open source, technical content, and authentic community presence. It's the developer-first application of broader B2B product marketing: same strategic frame (positioning, ICP, launches, enablement), different artifacts and channels. The launch motion in particular looks nothing like enterprise GTM — see the developer launch playbook for the day-of orchestration.

The buyer is technical and evaluates hands-on. That changes everything downstream. Working code samples replace demo decks. OSS presence replaces analyst relations. Docs replace marketing landing pages as the highest-conversion top-of-funnel asset. Communities replace sponsored events. The marketers who succeed at this have either lived inside developer-first companies long enough to internalize the buyer behavior, or apprenticed to someone who has. The flip side — why developer marketing fails in most B2B SaaS companies — is worth reading alongside this page.

The canonical reference is Mary Thengvall's The Business Value of Developer Relations. SlashData's Developer Economics Survey is the standard data source on developer audience behavior. For positioning specifically adapted for developer audiences, see developer-first product marketing and the positioning framework.

The eight axes below show where the discipline diverges in practice from generic B2B marketing — the right column is what a developer marketer actually has to deliver against.

Comparison of traditional B2B marketing vs developer marketing across eight operational axes.
AxisTraditional marketingDeveloper marketing
AudienceEconomic buyer (VP, Director, line-of-business owner)Hands-on developer evaluating the product themselves
MessageBusiness outcomes, ROI, productivity gainsTechnical specifics, working examples, honest tradeoffs
ChannelPaid LinkedIn, sponsored events, analyst relationsDocs, OSS, dev forums (HN, Reddit, Stack Overflow), community Discord/Slack
ProofCustomer logos, ROI deck, analyst quote, case studyWorking code, benchmarks, GitHub stars, sample app, public roadmap
FormatGated white paper, webinar, sales-led demoREADME, quickstart, tutorial, conceptual docs, technical blog post
Content tonePolished, brand-voice, anonymousNamed bylines, specific, no marketing fluff, opinionated
Attribution modelMQL → SQL → demo booked → pipelineAnonymous reach (docs, GitHub, HN) compounding into trial signups and weekly active devs
Success metricPipeline coverage, ARR per logoActivation, time-to-first-call, weekly active devs, trial-to-paid

Axes synthesized from Mary Thengvall's The Business Value of Developer Relations, Mark Birch's Developer Marketing Does Not Exist, and 12 years of in-house developer marketing experience across JetBrains, Lightrun, and Odigos.

The five channels that actually work

01

Documentation

Docs are the highest-conversion top-of-funnel asset for any developer-first product. Developers Google for problems and land on docs. Quickstart length, code-sample quality, conceptual clarity all directly drive adoption. Owned by PMM + DevRel + Engineering, not by Engineering alone.

02

Open Source

An OSS adjacent project (SDK, agent, exporter, CLI tool) signals credibility and creates a distribution surface. Even closed-source products benefit from a credible OSS layer. The most-cited reference is Mary Thengvall's work on DevRel-driven OSS strategy.

03

Technical Content

Tutorials, deep-dive blog posts, conference talks, and sample-code repos. Quality beats quantity by an order of magnitude. One viral Hacker News post outperforms 50 SEO-optimized listicle posts. Write under named bylines, not anonymous brand-voice.

04

Developer Community

Reddit, Hacker News, Stack Overflow, GitHub, Discord, dev.to. Communities you earn presence in by contributing — not channels you broadcast into. Underinvestment here is the single most common mistake in B2B DevTools marketing.

05

Integration partnerships

Showing up in the ecosystems developers already use (Kubernetes operators, VS Code extensions, GitHub Actions, Vercel integrations, etc.). Distribution leverage that compounds without per-customer cost.

By the numbers

The developer audience is large, measurable, and shifting fast. Two data points that explain why developer marketing is its own discipline.

Data point
47M+

Active software developers SlashData tracks worldwide — the addressable audience developer marketing actually targets. Channel strategy, message testing, and community work scale against this population, not a generic lead list.

SlashData Developer Nation · 2024→
Data point
76%

Share of developers using or planning to use AI tools in their development process — up from 70% the prior year. The technical-buyer evaluation surface is shifting under developer marketers in real time, including how developers find tools.

Stack Overflow Developer Survey · 2024→

Each figure links to the primary source. If a number moves in a subsequent annual report, this page gets updated.

Four common mistakes

Mistake 01

Hiring enterprise PMM by default

Generic B2B PMM applied to a developer audience produces inauthentic content and demos developers ignore. Hire someone with proven developer-audience experience, or work with a fractional who has.

Mistake 02

Treating docs as engineering output

Docs are top-of-funnel marketing. PMM should own the docs information architecture, code samples, and conceptual content. Engineering owns API reference and changelog only.

Mistake 03

Optimizing for demos booked

Demos booked is the wrong North Star for developer-first products. The right metric is activated free-tier users hitting the aha moment within their first session.

Mistake 04

Broadcasting into communities

Reddit, Hacker News, and GitHub are not channels you announce into. They're communities you earn presence in by contributing. Most companies underinvest by 10x.

Why docs is the highest-leverage marketing surface

A developer evaluating a tool follows a recognizable path: a Google search lands them on the docs, a quickstart runs in their terminal, the working code becomes the artifact they remember, and the docs site becomes the surface they return to. They do not bounce through a marketing landing page on the way. The docs site is the marketing site for the audience that matters.

That fact is rarely controversial when stated; it is consistently underacted on. Most DevTools companies budget docs as engineering output, scope it as a technical writer's deliverable, and measure it (when they measure it at all) as pages shipped. The companies that outperform treat docs as a marketing surface with engineering accountability, they fund it, instrument it, iterate on it, and assign joint ownership across the writer and the PMM.

This page maps the boundary between those two roles. The Write the Docs community is the canonical reference for the writing side; the developer-first PMM page covers the PMM side. The interesting work happens where the two surfaces meet.

Five phases of treating docs as a marketing surface

Each phase produces a concrete artifact or measurement, not an abstract orientation. A DevTools company that completes all five operates a docs surface that is meaningfully more productive than the median.

Phase 01: Recognize docs as a marketing surface

The docs site is the highest-traffic, highest-intent, highest-converting top-of-funnel asset most DevTools companies own. Underinvesting because it sits in the engineering org chart is the most common cause of soft top-of-funnel. The fix is structural: name docs as a marketing surface even when the writer reports into engineering, give the PMM a seat in the docs roadmap, and budget for content there the way you budget for blog content.

Phase 02: Structure the IA with Diátaxis

Four quadrants, Tutorials, How-to guides, Reference, Explanation. Each serves a distinct reader intent. Tutorials are the activation funnel; How-tos are the conversion artifacts; Reference is the SEO long tail; Explanation is the positioning surface. A docs site that mixes the four into a single navigation hierarchy without naming the intent always underperforms a site that names them explicitly. The framework is forty years old in its first form and increasingly the lingua franca of the field.

Phase 03: Quickstart as the activation funnel

The single highest-leverage docs page is the quickstart. A working quickstart that completes in under five minutes is the single biggest predictor of whether a docs visitor will become an activated user. The PMM and the writer should review the quickstart weekly the way an e-commerce team reviews a checkout flow, same physics, same measurement discipline. Latency, friction, ambiguous error messages each cost measurable activation.

Phase 04: Concepts and comparisons as the positioning surface

The Explanation quadrant is where positioning lives in docs. A concepts page that names the technical mental model honestly (and names the alternative mental models the audience may be carrying in from a competitor) does positioning work that no marketing landing page can do. Comparison pages and migration guides sit here too, these are read by the buyer evaluating the technical trade-offs, not by the casual visitor, and they are also the artifacts that show up in serious peer reference conversations.

Phase 05: Measure docs the way marketing measures funnels

Activation per docs page. Time-to-quickstart-complete. Top exit pages. Top search queries within the docs site. Top referring pages from Google. The instrumentation is the same instrumentation that a marketing team would apply to a landing page; the difference is that nearly nobody applies it to docs because docs are nominally engineering output. The first DevTools company that does the measurement well finds a list of two or three pages where small fixes produce outsized activation gains.

Why ML engineers buy differently

An ML engineer evaluating a tool runs a different process than a generalist developer evaluating a tool. The shape is similar, docs first, hands-on second, peer reference third, but the artifacts are different in ways that matter. The hands-on step is an eval against existing data, not a quickstart against a sample. The peer reference is the MLOps Community Slack or a researcher's blog, not a Hacker News thread. The pricing question is "what will this cost me at 10x volume" rather than "how many seats do we need."

The audience overlaps with generalist developers at the edges (full-stack engineers who occasionally call an LLM API are closer to generalist developers than to ML engineers; ML research engineers shipping production models are closer to the inverse). The DevTools company entering the segment has to decide which sub-segment it is selling to and write the artifacts accordingly. Trying to serve both with one set of artifacts usually produces copy that reads accurately to neither.

The developer-first PMM playbook's spine still applies. Latent Space is the closest thing the ML tooling field has to a daily-read trade publication, and Eugene Yan and Chip Huyen are the closest thing it has to canonical voices on applied ML systems. Reading either for two weeks is the fastest calibration available to a DevTools team entering the segment.

Five phases of entering the ML segment

The DevTools playbook adapted for an audience that prices in tokens and evaluates with reproducible procedures. The five phases below are the smallest version of the work that still produces credible artifacts; cutting further usually produces a launch that reads as ML-flavored generalist DevTools.

Phase 01: Recognize the segment as distinct

AI/ML engineers share a job title with generalist developers and very little else in their evaluation behavior. The pricing primitive is different. The discovery surfaces are different. The trust artifacts are different. The first move is to stop treating them as a sub-segment of generalist developers and start treating them as a distinct ICP with distinct artifacts, even when the core product serves both.

Phase 02: Ship the eval, not the benchmark

Benchmarks compress out-of-the-box. Evals are reproducible procedures with measurable outcomes on the buyer's data. The trust artifact for this audience is the eval: an explicit methodology, an explicit baseline, a published dataset (or procedure), and a published failure mode. Marketing copy that claims a performance number without a reproducible procedure behind it is read as marketing copy, not as evidence.

Phase 03: Price the token, not the seat

Per-developer-per-month pricing reads as out-of-date to ML engineers. The primitive that resonates is tokens, inference calls, model-eval runs, or compute hours. The pricing page should read like a cloud-provider pricing page: clear unit economics, visible cost-attribution features, a calculator. The FinOps-for-ML conversation is mature enough that any pricing structure that hides the unit cost gets discounted on suspicion of opacity.

Phase 04: Distribute through the right surfaces

Hugging Face Hub for model distribution. Hugging Face Spaces for demoable artifacts. Latent Space, individual researcher blogs (Eugene Yan, Chip Huyen, Simon Willison) for category coverage. The MLOps Community Slack and Discord for peer evaluation. Conference presence at NeurIPS, MLSys, MLOps World, PyData. Hacker News still works but is weaker signal than for generalist DevTools. The channel mix is different enough that the developer marketing reference plus an ML overlay is the right way to think about it.

Phase 05: Earn the technical credibility hire

The DevRel lead, founding engineer-PMM, or conference-circuit presence has to come from the ML research or applied-ML community, the audience identifies an outsider quickly. The GTM operator can come from the DevTools PMM community and pick up the ML-specific overlay; the technical credibility is harder to import. The team that lacks the credibility hire usually has positioning copy that reads accurately to a marketer and approximately to an ML engineer.

Why DevTools sales inside enterprises is a dual-audience problem

A self-serve DevTools company can run almost entirely on developer-first marketing. A developer finds the docs, signs up, activates, eventually pays with a credit card. The buyer and the user are the same person. The GTM motion is end-to-end inside one audience.

At the enterprise tier that compresses cleanly does not exist. The developer who signed up on the free tier is still the user, but the user no longer makes the purchasing decision. The engineering manager has a budget. The IT director has a procurement process. The security architect has a review checklist. The CIO has a tooling roadmap. Each of those people is a distinct buyer with distinct objections, and the DevTools company that has only invested in developer-first content has answered roughly one of four. The remaining three are what The New Stack, CIO.com, and InformationWeek cover as their default beat, and they cover it from the IT side of the table.

The wider developer-first PMM reference assumes the GTM motion lives entirely inside the developer audience. This page is the extension that handles the enterprise overlay, what changes when the user and the buyer diverge and the company has to speak credibly to both.

Five phases of an enterprise DevTools deal

The shape of an enterprise deal is consistent across DevTools categories. The duration varies; the phases do not. Naming the phases out loud inside the company makes the cycle predictable, which is the prerequisite to running a forecast that is not aspirational.

Phase 01: Developer love proves the product

Bottoms-up activation is still the entry point. The free tier, the docs, the working code samples, all of the developer-first PMM work has to be in place. Without it, the IT conversation has no anchor. The developer who installed the tool and got it working is the internal champion the AE will eventually need; the company that skips that step has nobody to write the business case from the customer side.

Phase 02: IT learns the product exists

The transition from team-level adoption to organizational standardization is where most DevTools companies stall. IT discovers the tool either through internal escalation (someone in security flags a SaaS app on the network) or through a deliberate land-and-expand motion (the AE reaches out once usage crosses a threshold). The artifacts IT wants at this stage are different: a security one-pager, a data-flow diagram, a compliance summary, a list of comparable enterprise customers. Build them before you need them.

Phase 03: Security review and procurement

SOC 2 Type II, SIG questionnaire, penetration test summary, subprocessor list, vendor onboarding paperwork. The DevTools company that has these documents ready compresses the cycle by months. The company assembling them on demand under deal pressure usually loses to a competitor that was prepared. Procurement then runs in parallel, MSA negotiation, payment terms, line item budget reconciliation. None of this is glamorous; all of it is rate-limiting.

Phase 04: Standardization decision

The CIO or VP Engineering decides whether the tool becomes a standard or a sanctioned exception. Standardization unlocks expansion (seats, modules, multi-year terms); exception status caps the deal size and leaves the renewal at risk. The decision is rarely made on product merit alone, it includes the integration footprint, the comparison against the existing toolchain, and the political question of which incumbent vendor the new tool displaces. The seller's job at this stage is to make the standardization decision easy by removing reasons to say no.

Phase 05: Renewal and expansion

The renewal is decided in month two, not month eleven. Usage signals (active developers, weekly active teams, depth of integration) and IT signals (zero open security findings, predictable invoicing, named champion still employed at the customer) determine whether expansion is realistic. A DevTools company that tracks usage at the team level inside the customer and shares a quarterly business review with the IT sponsor renews at a meaningfully higher rate than one that disappears after the contract signs.

FAQ

What is developer marketing?

Developer marketing is the discipline of building trust and adoption with developer audiences through documentation, open source, technical content, and authentic community presence. It's distinct from enterprise marketing (which sells to economic buyers via demos) and consumer marketing (which optimizes for emotional appeal). The buyer is the developer hands-on with the product; the artifacts that matter are working code, sample projects, and OSS credibility.

What's the difference between developer marketing and DevRel?

Developer relations (DevRel) is the broader discipline covering how a company builds trust with developer users; it includes both developer marketing (demand-gen aimed at developers) and developer advocacy (the customer-facing side: talks, tutorials, community moderation). Developer marketing focuses on top-of-funnel and acquisition; DevRel covers the full lifecycle.

What companies need developer marketing?

Any company whose buyer is technical and whose product gets evaluated hands-on: developer tools, open-source vendors, API and infrastructure companies, observability and security platforms, AI/ML infrastructure, internal developer platforms (IDPs), data engineering tools. Companies with non-technical buyers don't need this; standard B2B PMM works fine.

What's the most-cited reference on developer marketing?

Mary Thengvall's The Business Value of Developer Relations is the canonical practitioner book. SlashData's annual Developer Economics Survey is the standard data source. Brian Balfour's Reforge essays cover the loops + retention frameworks. For positioning specifically applied to developer audiences, April Dunford's Obviously Awesome plus the adaptation in /developer-first-pmm is the standard reference.

How is developer marketing different from product marketing?

Product marketing is the parent discipline; developer marketing is the developer-first application of it. The strategic framework is the same (positioning, ICP, launches, sales enablement, competitive intel). The artifacts and channels differ: working code samples instead of demo decks, OSS presence instead of analyst relations, docs instead of website copy. See the /developer-first-pmm reference for the full treatment.

What's the biggest mistake in developer marketing?

Treating developers like generic B2B buyers. Marketing teams that grew up in enterprise SaaS apply demo-led, gated-content, sponsored-event playbooks to developer audiences and get ignored. Developers detect marketing fluff in 3 seconds; specificity, working code, and honest tradeoffs win. The fix isn't to skip marketing but to do developer-first PMM with practitioners who have proven the playbook.

Is the docs site really a marketing asset or is that just PMM-speak?

It is the marketing asset. In a developer-first GTM motion, the docs site outperforms every other top-of-funnel surface a DevTools company owns, by traffic, by activation rate, and by long-tail compounding. A developer who arrives on a marketing landing page and bounces will arrive again from a Google search a week later, on the docs page that answers their actual question. The docs site is where the audience evaluates the product, where they convert into activated users, and where they later return to make purchasing decisions. Treating it as engineering output rather than as a marketing surface is the most common reason DevTools companies underperform on top-of-funnel.

Who owns the docs IA, the tech writer or the PMM?

The tech writer owns the IA. The PMM owns the positioning that the IA expresses. In healthy DevTools companies, the writer drives the structure (reference, tutorials, how-tos, conceptual explanations, the Diátaxis quadrants), and the PMM ensures that the structure surfaces the product's positioning in the right places (the landing page, the concepts section, the comparison and integration pages). The boundary breaks when one role tries to do the other's job: a PMM who rewrites tutorials usually breaks the technical accuracy, and a writer who rewrites positioning usually drains the differentiation.

Are AI/ML engineers really a distinct audience from generalist developers?

Yes, in ways that matter for GTM. The job title overlaps with software engineer, but the buying behavior diverges sharply. Token economics replaces seat economics as the unit. Model evaluation methodology (not just performance benchmarks) is the core evaluation surface. The infrastructure coupling is tighter, most ML tools have to land cleanly into a stack that already includes a vector database, an inference platform, an experiment tracker, and a notebook environment. A DevTools company that treats ML engineers as "developers who happen to do ML" usually misses on all four of these. The companies that win the segment treat it as a distinct ICP with distinct artifacts, while still inheriting the DevTools playbook's spine.

How does pricing differ for tools sold to AI/ML engineers?

Three shifts. First, the primitive moves from seats to tokens, inference calls, or model-eval runs. Pricing pages built around "per developer per month" read as out-of-touch to this audience. Second, the cost-curve compounding is real: ML workloads grow faster than software workloads, and a pricing model that does not account for that produces sticker shock on the second renewal. Third, the FinOps-for-ML conversation is mature enough that buyers will ask for cost-attribution features as a gating requirement. The pricing page that closes this audience reads more like AWS than like SaaS.

When the developer loves the tool, why does the enterprise IT contract still stall?

Because the developer is not the buyer. The developer is the user. The buyer is some combination of an engineering manager who owns the budget, an IT director who owns the procurement process, a security architect who owns the review, and a CIO who owns the standardization roadmap. Each of those people has different objections, and a DevTools company that has only spoken to the developer has answered roughly one quarter of the questions that will be asked. The contract stalls when one of the other three blocks the deal and the seller has no relationship there to recover with.

What does an enterprise security review actually want to see for a developer tool?

A current SOC 2 Type II report, a SIG (Standard Information Gathering) questionnaire response, a documented data-flow diagram showing exactly what leaves the customer's perimeter and where it lands, a vulnerability disclosure policy, a list of subprocessors, and evidence of penetration testing in the last 12 months. The fast-moving DevTools company often has the underlying controls but no documentation; assembling the artifacts becomes the bottleneck. The fix is to start the documentation work the moment the company has a single design-partner contract, not the moment the first enterprise deal lands. CISA's Secure by Design guidance and NIST SP 800-218 (the SSDF) are the policy frames most enterprise security teams will benchmark against.

Need help running it?

See how I work.

The four-week Growth Pilot: $5,000, two real growth experiments, a decision every Friday. For developer-tool and AI-product founders who don't have a growth lead yet.

See services

Ready when you are.

Discovery calls are 30 minutes. First one's on me.

Book a 30-minute call