Hacktoberfest'24 Official Website

Welcome to the official repository for Hacktoberfest'24 (GDG GEU x Vaunt), a collaborative event organized by Google Developer Groups on Campus at Graphic Era University in partnership with Vaunt.dev. This repository forms the core of the Hacktoberfest'24 initiative and is open for contributions from everyone! Whether you're a beginner or a seasoned developer, your contributions are valued here.

Table of Contents

• About Hacktoberfest'24
• Partnership with Vaunt.dev
• How to Contribute
  • Tier 1: Core Repository Contributions
  • Tier 2: External Repository Contributions
• Leaderboard and Participants Log
• Badges and Recognition
• Getting Started
• Code of Conduct
• License

About Hacktoberfest'24

Hacktoberfest'24 is part of the global, month-long Hacktoberfest celebration of open source software by DigitalOcean. This particular initiative, hosted by the Google Developer Groups on Campus at Graphic Era University, provides a welcoming space for developers of all skill levels to contribute to open-source projects.

This repository offers a 2-Tier Contribution System:

• Tier 1: Contribute directly to this core repository.
• Tier 2: Contribute to ANY other open-source repository of your choice and get recognized here.

Partnership with Vaunt.dev

We are proud to partner with Vaunt.dev, a powerful platform designed to enhance the developer experience. Thanks to Vaunt, participants in Hacktoberfest'24 can earn limited edition GitHub badges as a reward for their contributions.

Vaunt.dev not only sponsors this event but also helps manage the leaderboard and reward system for participants.

How to Contribute

Hacktoberfest'24 encourages contributions from everyone, regardless of their experience level. You can choose between two different contribution tiers:

Tier 1: Core Repository Contributions

In this tier, you contribute directly to the official Hacktoberfest'24 core repository. Follow these steps:

1. Find an Issue: Check the Issues tab and look for issues with [ISSUE] in the title. These are curated by the maintainers.
2. Create an Issue: If you find a bug or want to propose a feature, you can create a new issue with [ISSUE] in the title.
3. Submit a Pull Request: Once you've made the necessary changes, submit a pull request following this naming convention:

   pr-add-<your-name>-<PR-number>

   Example: pr-add-johndoe-123.

Tier 2: External Repository Contributions

You also have the freedom to contribute to any external open-source repository of your choice. Here’s how:

1. Choose an External Repository: Find an open-source repository you want to contribute to.
2. Get Your PR Merged: Submit a pull request to the external repository and get it merged successfully.
3. Create an Issue in This Repo: Once your external PR is merged, head over to the Issues tab in this repository, and create an issue titled [PR EXTERNAL] <your name>.
4. Submit Your Details: In your issue, provide the following information:
   • Your Name
   • GitHub Username
   • PR Number
   • Link to the PR
   • A brief description of your contribution
5. Update Participants Log: Once verified by a maintainer, you will be instructed to update the participants/participants.js file (see below for more details).

Leaderboard and Participants Log

After your contribution (either in Tier 1 or Tier 2) has been successfully verified, you will be featured on our Leaderboard! Here's how to update the participants/participants.js file:

1. Open participants/participants.js.

2. If this is your first contribution, add your details in the following format:

   {
       id: "<incremental id>",
       name: "<Your Name>",
       university: "<Your University>",
       img: <your image variable>,
       pr: [<PR number>],
       prLink: ['<PR link>'],
   },

3. If you have already made contributions before, do not create a new entry. Instead, simply add your new PR number and PR link to the existing entry. For example, if your entry looks like this:

   {
       id: "2",
       name: "John Doe",
       university: "Graphic Era University",
       img: johnDoe,
       pr: [1, 2],
       prLink: ['#link1', '#link2'],
   },

   And now you have a new PR (PR number: 3, PR link: #link3), you would update the pr and prLink arrays as follows:

   {
       id: "2",
       name: "John Doe",
       university: "Graphic Era University",
       img: johnDoe,
       pr: [1, 2, 3],
       prLink: ['#link1', '#link2', '#link3'],
   },

4. Make sure to follow the structure carefully, including your PR number(s) and link(s).

Badges and Recognition

Thanks to our partner Vaunt.dev, you can earn special GitHub badges based on your contributions during Hacktoberfest'24. Badges are awarded based on the following contribution levels:

• Participation Badge: For making at least 1 successful contribution (either Tier 1 or Tier 2).
• Active Contributor Badge: For making 5 successful contributions.
• Master Contributor Badge: For making 10 or more successful contributions.

Once verified, badges will be distributed via email or directly to your account.

Getting Started

Here’s how you can set up the repository locally:

1. Fork the repository to your own GitHub account.

2. Clone the repository to your local machine:

   git clone https://github.com/iamAyushChamoli/hacktoberfest-24.git

3. Navigate into the directory:

   cd hacktoberfest-24

4. Install dependencies (if applicable):

   npm install

5. Create a new branch for your changes:

   git checkout -b <your-branch-name>

6. Make your changes, commit, and push:

   git add .
   git commit -m "Your message here"
   git push origin <your-branch-name>

7. Create a pull request from your GitHub repository.

For detailed contribution guidelines, check our CONTRIBUTING.md file.

Code of Conduct

We expect all contributors to follow our Code of Conduct in order to create a safe and welcoming environment for everyone. Violations of the Code of Conduct will be taken seriously.

We’re excited to see your contributions! Let’s make Hacktoberfest'24 a great success together 🚀!