Skip to content

Latest commit

Β 

History

306 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

🌊 OpenSource-Hunt

Your First Open Source Contribution with OpenLake πŸš€

Welcome to OpenSource-Hunt, an interactive Open Source contribution challenge by OpenLake β€” the Open Source programming club of IIT Bhilai.

Build. Learn. Contribute.

Instead of just learning about Open Source, this repository gives you a chance to experience the complete contribution workflow yourself.

The repository contains intentionally introduced bugs, documentation issues, improvements, and beginner-friendly tasks.

Your mission:

Find an Issue β†’ Get Assigned β†’ Fork β†’ Branch β†’ Fix β†’ Commit β†’ Push β†’ Pull Request β†’ Review β†’ Merge πŸŽ‰


🌊 About OpenLake #alr fixed on main

OpenLake is IIT Bhilai's hub for Open Source innovation and collaborative development.

The community focuses on building real projects, learning together, and contributing to Open Source. The OpenLake GitHub organization hosts projects maintained by IIT Bhilai students across different technologies and problem domains.

Explore OpenLake:


🎯 What Is OpenSource-Hunt?

OpenSource-Hunt is a hands-on contribution challenge created to introduce newcomers to the real Open Source workflow.

The repository intentionally contains:

  • πŸ› Bugs
  • πŸ“š Documentation issues
  • 🎨 UI/UX improvements
  • β™Ώ Accessibility improvements
  • πŸ’» Code improvements
  • ✨ Small enhancements
  • πŸ“ Typographical errors
  • πŸ“± Responsive design issues
  • 🟒 Beginner-friendly tasks

You don't need to be an Open Source expert.

You just need to be willing to learn and contribute.


🏁 How It Works

1️⃣ Find an Issue

Head over to the Issues section and find something you would like to work on.

Look for labels such as:

good first issue
beginner friendly
easy
documentation
bug
enhancement
medium
help wanted

Choose an issue according to your current skill level.


2️⃣ Ask to Be Assigned

Found something interesting?

Comment:

/assign

Automated Github Actions will assign the issue to you.


3️⃣ Fork the Repository

Click the Fork button on GitHub.

This creates your own copy of OpenSource-Hunt under your GitHub account.


4️⃣ Clone Your Fork

Clone your fork:

git clone YOUR_FORK_URL

Move into the project:

cd OpenSource-Hunt

5️⃣ Create a Branch (Optional)

Never work directly on main. Create a branch for your issue:

git checkout -b fix/issue-12

Name it after what you're doing, for example:

fix/issue-12
docs/update-readme
feat/add-dark-mode

Keeping each issue on its own branch is what lets you work on more than one thing without your changes getting tangled together.


6️⃣ Make Your Changes

Now it's time to solve the issue! πŸ”Ž

Read the issue carefully and make only the changes required to solve it.

If you're stuck, don't hesitate to ask for help.

Remember:

Open Source is about collaboration, not just code.


7️⃣ Test Your Changes (Optional)

Before committing, run the project locally and confirm your fix actually works. Check that you haven't broken anything else while you were in there.

Then review exactly what you're about to commit:

git status
git diff

If you see files you didn't mean to change, sort that out before moving on.


8️⃣ Commit Your Changes

Stage your changes:

git add .

Create a meaningful commit:

git commit -m "fix: resolve issue #12"

Try to keep commit messages short and descriptive.


9️⃣ Push Your Branch

Push your branch to your fork:

git push origin fix/issue-12

Use the same branch name you created in step 5.


πŸ”Ÿ Create a Pull Request

Open your fork on GitHub.

Create a Pull Request against the original OpenSource-Hunt repository.

In the Pull Request description, link the issue:

Closes #12

This tells GitHub that your Pull Request solves that issue.


πŸ‘€ Pull Request Review

Once your Pull Request is submitted, an OpenLake maintainer will review it.

You might receive:

  • βœ… Approval
  • πŸ’¬ Suggestions
  • πŸ”„ Changes requested

Don't worry if changes are requested!

That's a normal part of Open Source development.

Make the requested changes, commit them, and push again:

git add .
git commit -m "address review comments"
git push origin fix/issue-12

Your Pull Request will update automatically.


πŸŽ‰ Merge!

Once your Pull Request is approved, it will be merged.

Congratulations! 🎊

You've just completed your first Open Source contribution.

You went through the same basic workflow used in real collaborative software projects.


🏷️ Issue Labels

Label Description
good first issue A great issue for your first contribution
beginner friendly Suitable for contributors with basic knowledge
documentation Documentation-related work
bug Something that isn't working correctly
enhancement A feature or improvement
easy A straightforward task
medium Requires moderate technical understanding
help wanted Contributors are especially encouraged to help

πŸ“š What You Will Learn

By participating in OpenSource-Hunt, you'll get practical experience with:

  • Git
  • GitHub
  • Issues
  • Forks
  • Branches
  • Commits
  • Pull Requests
  • Code Reviews
  • Issue Assignment
  • Collaboration
  • Open Source contribution practices

More importantly, you'll learn how contributors work together on real projects.


🀝 Contribution Guidelines

Before contributing, please read CONTRIBUTING.md.

Please remember:

  • Work only on issues assigned to you.
  • Don't duplicate another contributor's work.
  • Keep your Pull Request focused on one issue.
  • Test your changes before submitting.
  • Write clear commit messages.
  • Be respectful to other contributors.
  • Ask questions when you're stuck.

🌱 First Time Contributing?

That's completely okay!

You don't need years of programming experience to get started.

Start with an issue labelled:

good first issue

or:

beginner friendly

Documentation and simple fixes are also excellent ways to make your first contribution.

Your first Pull Request doesn't need to be perfect.

It just needs to be your first step.


🌊 OpenLake Philosophy

OpenLake's philosophy is simple:

Build. Learn. Contribute.

OpenSource-Hunt follows the same idea.

Build something meaningful.

Learn from the process.

Contribute to something bigger than yourself.


πŸš€ Find It. Fix It. Contribute It.

Welcome to Open Source.

Welcome to OpenLake. 🌊

🌐 openlake.in Β· πŸ’» github.com/OpenLake Β· πŸ“Έ @openlake_iitbhilai

Happy Contributing! πŸ’™

About

An interactive Open Source contribution challenge where participants find and fix beginner-friendly issues, improve documentation and code, and experience the complete GitHub workflow from issue to pull request.

Resources

Contributing

Stars

10 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages