Start Contributing Today: Your First Open-Source PR (Step-by-Step)

Make your first open-source PR: fix docs, add a test, or close a bug. Step-by-step beginner guide to your first contribution in under an hour.

Helping out on open-source projects is one of the quickest, most practical ways to grow as a developer.

It teaches you how to work with others, builds good habits like writing tests, keeping docs up to date, and making reproducible builds, and it gives you real work to put on your resume.

This is something I wish I started a lot earlier in my career, something I skipped over thinking I wasn’t good enough or didn’t need to bother. I was wrong, big time.

A lot of people assume you need to rewrite big chunks of code or invent clever algorithms to be useful — that’s not true.

Each week, I dive deep into Python and beyond, breaking it down into bite-sized pieces. While everyone else gets just a taste, my premium readers get the whole feast! Don't miss out on the full experience – join me today!

There are simple, high-impact ways to help right away, especially in Python projects where many maintainers welcome first-time contributors.

This article walks through three easy contribution paths you can start today: improving documentation, adding tests or small code fixes, and triaging issues or writing clear bug reports.

For each path I explain why it matters, how to pick a target project, step-by-step actions — including exact Git/GitHub commands and a tiny pytest example — and practical tips that make it more likely your contribution will be accepted.

I’ll also share resources so you can find beginner-friendly issues right away. These approaches work: experienced maintainers point new contributors to docs, tests, and “good first issues” because they actually add value and are easy to get started with.

👉 Premium readers can access all the content.

👉 Download my Handcrafted Guides.

👉 Gain access to my full article archive.

👉 and Recommend projects at the bottom.

If you haven’t subscribed to my premium content yet, you need to check it out. You unlock exclusive access to all of these articles and all the code that comes with them, so you can follow along!

Plus, you’ll get access to so much more, like monthly Python projects, in-depth weekly articles, the '3 Randoms' series, and my complete archive!

👉 Thank you for allowing me to do work that I find meaningful. This is my full-time job so I hope you will support my work.

If you get value from my work, consider joining premium. It really helps me keep going and lets me know you’re getting something out of my work!

If you’re already a premium reader, thank you from the bottom of my heart! You can leave feedback and recommend topics and projects at the bottom of all my articles.

👉 If you get value from my work, please help me out, leave it a ❤️, and share it with others who would benefit from this. Thank you so much!