Skip to main content

Lesson 6 of 6 · 20 min

Finding real projects and making your first real contribution

How to read CONTRIBUTING.md, find 'good first issue' labels, and survive code review.

Find a project that wants beginners

Good first targets:

  • Projects tagged good-first-issue on GitHub — try goodfirstissue.dev or search GitHub for label:"good first issue" language:python (swap in your language).
  • FOSS Andhra's own repositories and FOSSynC club projects — mentors here expect beginners.

Read before you write

Every serious repo has two files at the top:

  • README.md — what the project does and how to run it.
  • CONTRIBUTING.md — the rules for contributing: branch naming, commit style, how to run tests, what to include in a PR. Read it. Maintainers close PRs that ignore it, not out of rudeness, but because consistency is what keeps projects maintainable.

Set up the project locally

Fork the repo on GitHub (the Fork button), then:

git clone https://github.com/YOUR-USERNAME/PROJECT.git
cd PROJECT
# follow the README's setup steps

Small PRs win

Your first PR should be tiny:

  • Fix a typo or broken link in the docs.
  • Improve an error message.
  • Add a missing step to installation docs.

Small PRs get merged fast, teach you the full flow, and put your name in a real project's history. A common beginner mistake is a 500-line first PR — reviewers will not get to it.

Surviving code review

Review comments are about the code, not about you. Expect:

  • Changes requested — normal; push new commits to the same branch and the PR updates itself.
  • Silence for days — normal; maintainers are volunteers. A friendly nudge after a week is fine.

Your checklist for any first contribution

  1. Read README and CONTRIBUTING
  2. Find a good first issue and comment "I'd like to work on this"
  3. Fork, clone, branch
  4. Small, focused change with a clear commit message
  5. Push, open PR describing what and why
  6. Respond politely to review

Congratulations — you now know everything a first-year FOSSynC club member needs. Bring your questions to your campus club or FOSS Andhra community events.

Finished this track? FOSS Andhra certificates are issued for internships, workshops and events — check what you can earn next.