Skip to main content

Everyone Contributes

3 min read

Summary: Code is just one way to contribute to open source. Projects thrive when they create clear paths for non-technical contributors to participate, from filing bugs to improving docs.

We often think of contributors as developers, but code is just one of the many ways to contribute to an open source project, and it’s important to provide avenues of participation for non-technical contributors as well.

Think through the spectrum of stakeholders that an open source project touches throughout its lifecycle. On the one extreme, you may have a non-technical, non-user stakeholder, such as a boss, or the one paying the hosting bills, and at the other extreme, you’ve got a potential developer that hasn’t yet learned your project exists. I like to think that the list looks something like this:

  • Non-technical, non-user stakeholders
  • Potential users
  • Veteran (or curious) users
  • Subject-matter experts (accessibility, content, i18n)
  • Technical users
  • Active developers
  • Potential developers

Each of these potential contributors has a unique set of needs, but more importantly, has a unique ability to contribute in a way that others may not. What participation products is your project producing to satisfy a potential contributor’s itch at each point along that continuum? Does each have a clear path to contribute?

Think through their needs. A potential user, with a fresh set of eyes, is uniquely positioned to answer the question “does this thing do what it says it does?”, while a regular core contributor may be well suited to recruit other, not-yet-engaged developers. The possibilities are both endless and unique to your project, but to name a few:

  • Kick the tires, does it work?
  • Answer the question: “what features would you love to see?”
  • Flesh out documentation, note where documentation is lacking
  • Community evangelism, speak, teach, and spread your love for the project
  • Submit new questions to the project’s Q&A forums, or take a stab at an answer
  • Host a genius bar at the next local meetup
  • Translate the project into a different language
  • Give feedback on proposed bugfixes and features, propose new ones
  • Recruit new developers

There’s a lot to be done. Most open source projects’ readmes outline technical requirements and how to submit a pull request, but most are notably silent on how non-technical stakeholders can begin to contribute. Few provide enough encouragement to overcome the inherent scariness of trying something new. What if you could double the size of your open source project’s community overnight?

Version your documentation alongside your project’s source code, and encourage non-developer users to use tools like prose.io to submit improvements. Point non-coders to Issues, and get them involved discussing features early along the pipeline. Connect them with a local technology meetup, and let them teach others. Empower them to contribute any way they know how. Give them an out, and make the experience awesome.

Open source is described as community, but we have to realize it’s not just a community of developers, nor should it necessarily be developer-centric. If you’re only explicitly providing avenues for contributions as code, sad to say, you’re ignoring half your community. Actively seek to minimize contributor friction, and keep the implicit promise: if I have the contributor itch, I can quickly find an existing opportunity to contribute, I’m encouraged to do so, and I have the tools I need.

Keep reading

Ben Balter

I'm Ben Balter, and I write here about developer platforms, product and engineering leadership, open source, and showing your work. I spent over a decade building developer platforms at GitHub. For five years I was a product manager for trust and safety, shipping 500+ features and the API endpoints behind them to 50M+ developers. I also led a bottom-up rewrite of GitHub Pages and wrote the open source library behind GitHub's license detection, and my open source projects have hundreds of millions of downloads. I wrote Open and Async, the playbook for remote and distributed teams, and shipped a Model Context Protocol (MCP) server alongside it so agents can query it directly. More about the author

Follow along: Bluesky LinkedIn

Originally published August 11, 2013 View revision history

This page is open source Help improve this article on GitHub

Keyboard shortcuts

Search

  • / or ⌘ K Open search
  • ↓ or j ↑ or k Move through results
  • Enter Open the selected result
  • Esc Close search

Go to

  • g then h Home
  • g then p All posts

This page

  • y Copy link to this page
  • ? Show this list

Turn off if you use voice control or keep triggering them by accident. ⌘ K still opens search, and this list stays under "Keyboard shortcuts" in the footer.