BetaDEVAE is in beta — things may break.
Guides

How to contribute to open source as a beginner

Beginners contribute to open source by picking one project they already use, starting with documentation or a labelled beginner issue, and following the project’s contributing guide exactly.

July 25, 20263 min readDEVAE Team

To contribute to open source as a beginner, pick one project you already use, read its contributing guide, set it up locally, and start with a documentation fix or an issue labelled for beginners. Your first contribution should be small enough to merge in a week, not a feature.

1. Pick a project you use

Contributing to something you use daily means you understand the users and you will notice real problems. Look at the tools in your own stack: a library, a CLI, a framework plugin. Check that the project is active (commits in the last month, maintainers responding to issues) and that it has a CONTRIBUTING file. Read that file twice.

2. Set it up and run the tests

Clone it, follow the setup instructions, run the test suite. This alone often produces your first contribution: setup instructions are frequently out of date, and a pull request fixing them is welcome everywhere. It also proves to yourself that you can work in the codebase.

3. Find a small, claimable task

Look for labels like "good first issue", "help wanted" or "documentation". Read the issue and the linked code before commenting. Then claim it: "I'd like to take this. My plan is X — does that match what you had in mind?" Wait for a maintainer to confirm; it avoids duplicate work.

4. Open a small pull request

Keep it focused: one issue, one change. Title it clearly, describe what changed and why, link the issue, and make sure tests pass. If the project has a PR template, fill every section. Small PRs get reviewed; large ones from strangers get ignored.

5. Handle review well

Reviews are the point. Respond within a day or two, make the requested changes without arguing about style, and ask questions when you do not understand a request. Two or three rounds is normal. When it merges, say thank you; maintainers remember polite contributors and offer them bigger issues.

Where to find projects and people

  • Your own dependencies: run through package.json or requirements.txt.
  • Good-first-issue aggregators and the "help wanted" label on GitHub.
  • Community hubs for your language, where maintainers often post asks; on DEVAE the open-source and stack communities carry these.
  • Pair with someone who has contributed before; a live room walking through your first PR removes most of the fear.

Common beginner mistakes

  • Opening a huge PR nobody asked for.
  • Rewriting code style across files the issue did not touch.
  • Going silent after review comments.

After the first merge

Do two more in the same project before moving on. Three merged PRs in one place gets you noticed by its maintainers, which is where invitations to do more interesting work come from.

A worked example

A bootcamp graduate uses a popular date-formatting library and notices the README's TypeScript example does not compile. She opens a one-line PR fixing the example, following the template. It merges in two days. Encouraged, she takes a "good first issue" about a missing error message, comments her plan, waits for a maintainer's thumbs-up, and opens a PR with a test. Review asks for a clearer message and a changelog entry; she updates within a day. Second merge. Her third PR, a small feature, is invited by the maintainer directly. Three merges in six weeks, all in one project.

Questions people ask

**What if my PR is ignored?** Wait a week, then post a polite nudge on the PR. If nothing happens in a month, the project may be under-maintained; move on without hard feelings.

**Do documentation contributions count?** Yes, and they are often the most valuable first contributions because they are what beginners notice and maintainers neglect.

**Should I contribute to famous projects for the résumé line?** Contribute where you can be useful. A merged fix in a mid-sized project you understand beats an unmerged PR to a framework with a thousand open ones.

Build it with company

Get started freeTakes about 30 seconds. Free for individuals, forever.