Your journey into open source starts here!
This repository exists for one purpose: to help you make your first pull request and start contributing to open source projects with confidence.
A Pull Request (PR) is how you propose changes to a project on GitHub. It's the fundamental way developers collaborate on open source projects. By making your first PR here, you'll learn the complete workflow used by millions of developers worldwide.
✅ How to fork a repository
✅ How to clone and work locally
✅ How to create a branch
✅ How to commit changes
✅ How to push to GitHub
✅ How to create your first Pull Request
Before you begin, make sure you have:
- ✅ A GitHub account (Sign up here)
- ✅ Git installed (Download here)
- ✅ A code editor (VS Code recommended)
Click the Fork button at the top right of this page.
git clone https://github.com/YOUR-USERNAME/first-pull-request.git
cd first-pull-requestReplace YOUR-USERNAME with your actual GitHub username
git checkout -b add-your-nameUse a descriptive name like add-john-doe
Open the CONTRIBUTORS.md file and add your name in this format:
- [Your Name](https://github.com/your-username) - Your location (optional)Add it in alphabetical order by first name!
Example:
- [Dhanush Nehru](https://github.com/DhanushNehru) - Bangalore, Indiagit add CONTRIBUTORS.md
git commit -m "Add [Your Name] to contributors list"git push origin add-your-name- Go to your forked repository on GitHub
- You'll see a Compare & pull request button - click it!
- Add a title:
Add [Your Name] to contributors - Click Create pull request
Perfect if you don't want to install Git yet!
- Fork this repository (button at top right)
- Go to
CONTRIBUTORS.mdin your forked repository - Click the pencil icon ✏️ to edit
- Add your name in alphabetical order
- Scroll down, add commit message:
Add [Your Name] to contributors - Click Commit changes
- Click the Pull requests tab
- Click New pull request
- Click Create pull request
- Add title and click Create pull request again
Done! That's your first PR! 🚀
- ✅ A maintainer will review your Pull Request
- ✅ If approved, your PR will be merged
- ✅ Your name appears in the contributors list
- ✅ You get notified when it's merged
- 🎊 You're officially an open source contributor!
Fork → Clone → Branch → Change → Commit → Push → Pull Request → Review → Merge
This is the standard workflow used across thousands of open source projects!
- ✅ Safe environment - mistakes are welcome
- ✅ Quick feedback - PRs reviewed fast
- ✅ Real workflow - same process as major projects
- ✅ Build confidence - practice before contributing elsewhere
After your first PR is merged, try these:
- Add Your Portfolio: Portfolios For Inspiration
- Find beginner issues: Good First Issue
- Explore projects: GitHub Explore
- Join events: Hacktoberfest
Common Issues:
❌ "Permission denied" error
Make sure you cloned your fork, not the original repository.
git remote -vShould show your username, not the original repo owner.
❌ "Branch already exists" error
Use a different branch name:
git checkout -b add-your-name-v2❌ Merge conflicts
Update your fork with the latest changes:
git pull origin mainThen resolve conflicts and commit again.
Still stuck?
- Check existing Issues
- Create a new issue - we're here to help!
- Remember: Every expert was once a beginner 🌱
Thanks to everyone who made their first pull request here! 🎉
Total Pull Requests:
We're committed to providing a welcoming environment. Please read our Code of Conduct.
TL;DR: Be kind, be respectful, be helpful.
This project is licensed under the MIT License - see LICENSE for details.
Made your first PR? Share it with the world!
- Tweet about it with #first-pull-request and #OpenSource
- Add it to your LinkedIn profile
- Tell your friends who want to start contributing
If this helped you make your first contribution, please give it a ⭐
Help others discover this resource and start their open source journey!
Made with ❤️ for aspiring open source contributors
Make Your First PR | View Contributors | Report Issue
