SoftLinkers All articles
Career & Community

Why Most Open Source Contributors Never Come Back After Their First PR

SoftLinkers
Why Most Open Source Contributors Never Come Back After Their First PR

Here's a pattern that plays out constantly in open source: someone finds a project they genuinely care about, spends a weekend fixing a real bug or improving the docs, submits a pull request, and then... disappears. No second contribution. No ongoing involvement. Just a name in the commit history that never shows up again.

Project maintainers tend to chalk this up to life getting in the way — contributors are busy, priorities shift, interest fades. And sure, sometimes that's true. But when it happens at scale, when your contributor retention looks like a revolving door, the problem isn't the contributors. It's the experience you're giving them.

The open source ecosystem runs on people choosing to invest their time for free. If that investment doesn't feel worthwhile after the first interaction, they're not coming back. That's not a mystery. That's just how humans work.

The Hidden Cost of a Cold Onboarding

Most open source projects treat onboarding as an afterthought. There's a CONTRIBUTING.md file somewhere that was last updated in 2019, a vague instruction to "check open issues," and maybe a label called good first issue attached to tickets that are anything but.

New contributors are expected to figure out the project's conventions, testing setup, code style preferences, and unwritten rules largely on their own. When they inevitably get something slightly wrong — a missed lint rule, an unconventional commit message format, a test that wasn't quite comprehensive enough — the feedback they get is often terse, technical, and delivered without any warmth.

Nobody's being malicious here. Maintainers are stretched thin. But from the contributor's perspective, the message received is: your effort wasn't good enough, and we're too busy to help you understand why. That's a hard experience to voluntarily sign up for twice.

Successful projects invest real thought into making that first interaction feel welcoming. The Rust community built a reputation for thorough, kind code reviews long before it became a popular language. That reputation became a recruitment tool. People wanted to contribute because the review experience was good.

Governance Ambiguity Is Quietly Killing Your Community

Another major contributor to the one-and-done problem is unclear project governance. When someone submits a pull request and it sits unreviewed for three weeks, then gets a single comment asking for changes, then goes quiet for another two weeks, they have no idea what's actually happening. Is the project still active? Is their contribution wanted? Did they do something wrong?

Uncertainty is exhausting. People don't stick around for it.

Projects that retain contributors tend to be explicit about how decisions get made, who has authority to merge what, and what the expected timeline for review actually is. Even if the answer is "we're a small team and reviews might take two weeks," saying that upfront changes everything. It reframes silence as a known process rather than a rejection signal.

Some projects have moved to lightweight governance documents — not the full Apache-style governance model, but something simple that answers: Who maintains this? How do I get my PR noticed? What does the path to becoming a regular contributor look like? These documents exist to reduce ambiguity, and reducing ambiguity keeps people engaged.

Feedback Loops That Actually Build People Up

Here's something the best open source communities understand that the struggling ones don't: feedback isn't just about code quality. It's about whether a person walks away from the interaction feeling capable or defeated.

A pull request review that says "this approach won't work because of X, Y, and Z" is technically useful. A review that says "this approach won't work because of X, Y, and Z — here's a pattern we've used elsewhere in the codebase that might help" is the same information delivered in a way that actually builds the contributor's understanding of the project.

The difference in effort is maybe five minutes. The difference in outcome is whether that person feels equipped to try again.

Projects like Ruby on Rails and VS Code have invested heavily in making their review processes educational rather than purely evaluative. Contributors who learn something from the interaction are far more likely to come back — not just because they feel good, but because they now have context that makes the next contribution easier.

The Recognition Problem Nobody Wants to Admit

Let's be honest about something: a lot of contributors are showing up at open source projects because they want to grow professionally. They want to build a portfolio, develop skills, get their name associated with something respected in the community. That's not a cynical motivation — it's a completely reasonable one, and it's worth acknowledging.

Projects that ignore this reality miss an easy opportunity. Publicly recognizing contributors in release notes, changelogs, or social posts costs almost nothing and signals that the project values the people who show up. It also creates a visible record that a contributor can point to when they're job hunting or building a reputation in their area of expertise.

All-contributors bots, contributor spotlights in newsletters, shoutouts in community Discord servers — these aren't vanity exercises. They're retention mechanisms. People stay where they feel seen.

Turning One-Time Contributors Into Invested Community Members

If you're a maintainer reading this and recognizing some of these patterns in your own project, here's where to start:

Audit your first contribution experience. Actually try to submit a contribution to your own project as a newcomer. How long does it take to understand what's needed? Where do you get stuck? Fix those friction points before anything else.

Set explicit response time expectations. Even if you can't promise fast reviews, tell contributors what to expect. A simple note in your CONTRIBUTING.md that says "we aim to respond to new PRs within 10 business days" is infinitely better than silence.

Assign a point person for new contributors. Not every project can do this, but even rotating the responsibility among existing maintainers helps. Having one person whose job it is to make newcomers feel welcome changes the energy significantly.

Create a visible path forward. If someone submits a great first PR, tell them. Tell them what kinds of issues they might be ready to tackle next. Give them a reason to stay engaged rather than leaving them to wonder.

Treat your contributor community like a community. This sounds obvious, but many projects operate more like code repositories with a submission form than actual communities. Regular communication, a welcoming chat channel, acknowledgment that real people are involved — these things matter.

The Projects That Get This Right Have Something in Common

The open source projects with healthy, growing contributor bases aren't necessarily the ones with the most interesting technical problems or the biggest company backing them. They're the ones that figured out how to make contributing feel like belonging.

SoftLinkers exists because developers need to connect — not just with tools and libraries, but with each other. The same principle applies to open source communities. The code is almost secondary. What keeps people coming back is whether they feel like they're part of something, whether their effort is valued, and whether the experience of contributing makes them better at what they do.

The collaboration tax is real. Every friction point in your contribution workflow, every unanswered PR, every terse review that leaves someone more confused than when they started — these are costs being paid in people who could have become your most valuable contributors but chose to spend their time somewhere else instead.

The good news is that most of these costs are optional. You can stop paying them whenever you decide to.

All Articles

Related Articles

Ship Ugly, Ship Early: Why the Best Developer Tools Were Never Born Perfect

How Smart Teams Actually Break Down Silos (Without Buying Another SaaS Tool)

How Smart Teams Actually Break Down Silos (Without Buying Another SaaS Tool)

Why Fast-Moving Engineering Teams Are Ditching Synchronous Workflows for Event-Driven Design

Why Fast-Moving Engineering Teams Are Ditching Synchronous Workflows for Event-Driven Design