Participation

Everyone is welcome

Participants in Hacktoberfest come from all over the world and represent thousands of unique skill sets. We welcome anyone who is interested in diving in, and everyone who’s already part of the open-source software community.

Quantity is fun, quality is key

Participating in Hacktoberfest leads to personal growth, professional opportunities, and community building. But it all begins with meaningful contributions to open-source software. We’re committed to prioritizing quality contributions as outlined in our participation rules.

Short-term action, long-term impact

In the open-source community, we stand on the shoulders of project maintainers and those who came before us. Your participation has a lasting effect on people and technology long after October. Your participation helps build the future of the internet.

Participating in Hacktoberfest

Here’s what you need to know to participate and complete Hacktoberfest:

  • Register anytime between September 23 and October 31
  • Pull/merge requests can be made in any GitHub or GitLab hosted project that’s participating in Hacktoberfest (look for the “hacktoberfest” topic)
  • Aim to submit four high-quality pull/merge requests between October 1 and October 31, with project maintainers accepting your pull/merge requests for them to count toward your total
  • You’ll unlock a digital badge when you register for Hacktoberfest, and level it up with each of your four pull/merge requests accepted during Hacktoberfest

Join the Hacktoberfest Discord server to meet other participants and share your Hacktoberfest love with a blog or post on socials.

Pull/Merge Request Details

Here’s how we validate contributor pull/merge requests (“PR/MRs”) for Hacktoberfest

[out-of-bounds] Your PR/MRs must be within the bounds of Hacktoberfest.

Your PR/MRs must be created between October 1 and October 31 (in any time zone, UTC-12 thru UTC+14).

Your PR/MRs must be made to a public, unarchived repository.

Pull/merge requests created before October 1 but merged or marked as ready for review after do not count.

[excluded] Repos that go against Hacktoberfest’s values will be excluded from qualification and PR/MRs made to those repos won’t count.

Found a repository that goes against the values of Hacktoberfest? Let us know and we’ll take a look.

[spam] Your PR/MRs must not be spammy.

PR/MRs that are labeled with a label containing the word “spam” by maintainers will not be counted.

  • We use the Node.js RegEx engine with /\bspam\b/i to look for spam labels.
  • PR/MRs that also have the “hacktoberfest-accepted” label cannot be marked as spammy via a label.
  • PR/MRs that have been merged and do not have a label containing the word “invalid” cannot be marked as spammy via a label.

 

PR/MRs that our system detects as spammy will also not be counted.

Any user with two or more spammy PR/MRs will be disqualified.

[participating] Your PR/MRs must be in a repo tagged with the “hacktoberfest” topic, or have the “hacktoberfest-accepted” label.

Hacktoberfest is now opt-in for maintainers, so only contribute to projects that indicate they’re looking for Hacktoberfest PR/MRs.

Once your PR/MR has passed this check, we won’t check this again (unless your PR/MR fails a check before this, such as it being marked as spammy).

Your PR/MR must match criteria to be considered participating before Hacktoberfest ends on October 31 (in any time zone, UTC-12 thru UTC+14) to be counted.

[invalid] Your PR/MRs must not be labeled as “invalid”.

PR/MRs that have a label containing the word “invalid” won’t be counted, unless they also have the “hacktoberfest-accepted” label.

Specifically, we use the Node.js RegEx engine with /\binvalid\b/i to look for invalid labels.

[accepted] Your PR/MRs must be merged, have the “hacktoberfest-accepted” label, or have an overall approving review.

Your PR/MR must not be a draft to be considered accepted.

If your PR/MR is being accepted for Hacktoberfest via an overall approving review it must also not be closed.

Your PR/MR must be accepted by a maintainer before Hacktoberfest ends on October 31 (in any time zone, UTC-12 thru UTC+14) to be counted.

Once your PR/MRs pass all the checks above, it will be accepted for Hacktoberfest after the seven day review period.

We continually evaluate all of the checks until your PR/MR completes the seven-day review period, except the [participating] check which is a one-time check. If it fails any of these checks during this time, the seven day timer will reset.

After the seven day review period completes, your PR/MR will be automatically accepted for Hacktoberfest assuming it still passes all the checks. Once accepted for Hacktoberfest, we stop checking. :party:

PR/MRs that are passing all checks and are still in the review period on October 31 can continue the seven-day review period into November.

Measures to Reduce Spam

To ensure quality contributions to Hacktoberfest, we empower maintainers to label pull/merge requests as “spam” at their own discretion, all pull/merge requests you submit must be approved by the project maintainer, and repos that try to game the system will be excluded from Hacktoberfest.

Spammy pull/merge requests will be labeled as “spam.”

Maintainers: label spammy requests “spam” and close them. PR/MRs labeled “spam” won’t count toward Hacktoberfest. Contributors with 2+ spammy PR/MRs are disqualified.

Pull/merge requests must be approved by a maintainer.

Maintainers accept PR/MRs by merging them, labeling them “hacktoberfest-accepted,” or giving them an overall approving review. Accepted PR/MRs enter a seven day review window, during which approval can be revoked by the maintainer or by our team.

Bad repositories will be excluded.

PR/MRs should be useful to maintainers. Repos that encourage simplistic PR/MRs (like adding a name or profile to a list or arbitrarily curating content) will be excluded from Hacktoberfest. Remember: quantity is fun, quality is key.

Found a repository that you think doesn’t follow our values? Report it to us and we’ll take a look.

Avoid submitting low-quality pull/merge requests.

Hacktoberfest is about contributing meaningfully to open-source projects. Here are some examples of low-quality pull/merge requests that won’t count towards Hacktoberfest.

  • Automated pull/merge requests: scripted opening pull requests to remove whitespace, fix typos or optimize images.
  • Disruptive pull/merge requests: taking someone else’s branch/commits and making a pull request.
  • Anything that a project maintainer flags as spam.
  • Anything that looks like an attempt to duplicate your pull request count for October.
  • Multiple pull/merge requests for the same issue that are unnecessary, for example four PR/MRs to remove a stray whitespace.

Maintainers

Prepare your project for contributions by following these best practices:

  • Add the “hacktoberfest” topic to your repository to opt-in to Hacktoberfest and indicate you’re looking for contributions.
  • Apply the “hacktoberfest” label to issues you want contributors to help with in your GitHub or GitLab project.
  • Add a CONTRIBUTING.md file with contribution guidelines to your repository.
  • Choose issues that have a well-defined scope and are self-contained.
  • Adopt a code of conduct to create a greater sense of inclusion and community for contributors.
  • Be ready to review pull/merge requests, accepting those that are valid by merging them, leaving an overall approving review, or by adding the “hacktoberfest-accepted” label.
  • Reject any spammy requests you receive by labeling them as “spam,” and any other invalid contributions by closing them or labeling them as “invalid.

Low or Non Code Contributions

At its core, Hacktoberfest aims to encourage more people to participate in open source and collaborate to enhance the software driving our world today. Open source projects can benefit greatly from community contributions, and there are a multitude of ways to get involved that don’t involve coding skills. Whether you possess technical expertise or not, you can leverage your professional skills to support open-source projects. In line with last year’s effort, we’re committed to promoting contributions that don’t require technical knowledge. Visit GitHub’s The ReadMe Project to learn more

Low or Non Code Contributions

Low-code and non-code contributions are an excellent way to get involved in supporting open source. Here are some examples of ways you can contribute to open-source projects:

  • Technical documentation
  • User experience testing
  • Technical blog post or tutorial
  • Case studies

Non-Code Contributions:

  • Writing
  • Translating
  • Copy editing
  • Talks or presentations
  • Event organization
  • Podcasts
  • Social media
  • Blog posts
  • Video production
  • Graphic design

Note: If you’re submitting low- or non-code content to projects, make sure to create a PR/MR to track your contribution.

Although Hacktoberfest tracks all PR/MRs submitted for the event, maintainers may need to facilitate tracking of those contributions through an activity log or similar.

For Maintainers: How to attract low or non-code contributions.

FAQs

[Rewards] Do I get a reward for participating?

Aside from the knowledge you’ll gain, (and the fun you’ll have) you’ll get a digital badge through Holopin to represent your participation in Hacktoberfest. As each of your four pull/merge requests is accepted by a maintainer, you’ll unlock a new level in your badge, letting you customize it and showing to the community your achievement.

[Rewards] How will I receive my digital badge?

You will receive a notification in your Hacktoberfest profile on the Hacktoberfest website. Additionally, you will receive an email from Holopin to claim each level of your badge.

[Rewards] When do I need to claim my badges by?

Hacktoberfest profiles close on December 15. Please make sure you’ve claimed all your Holopin badges using the claim links on your profile (also sent via email).

[Rewards] Why isn’t there a t-shirt this year?

As Hacktoberfest has grown, so have the logistical challenges associated with creating a reward. Unfortunately, it’s no longer feasible for us to provide a free t-shirt. Nevertheless, we still want participants to have a memorable experience and receive a special memento marking their participation and the year. Instead of a t-shirt reward, we’re partnering with Holopin to provide a digital badge to each participant, making global delivery much simpler. We believe this shift will allow Hacktoberfest to continue supporting and raising awareness for open-source projects worldwide for years to come.

[Rules] I signed up for Hacktoberfest mid-October. Will pull/merge requests that I created earlier in October count?

Yes, all pull/merge requests created between October 1 and October 31 will count, regardless of when you register for Hacktoberfest.

[Rules] Do pull/merge requests made on my own repositories count?

Yes, but we strongly encourage you to make quality contributions to other repositories.

[Rules] Do multiple pull/merge requests to the same repository count?

Yes, each pull/merge request will count separately.

[Rules] Do issues/commits count?

No, only pull/merge requests count.

[Rules] Do issues have to be tagged as Hacktoberfest to count?

No, pull/merge requests for Hacktoberfest do not need to be attached to a hacktoberfest issue.

[Rules] Do contributions made outside of GitHub or GitLab count?

Pull/merge requests must be made on either the GitHub or GitLab platform.

[Rules] What should I do if I contribute to a repository that is not participating in Hacktoberfest?

You can politely request that the maintainer of the project you contributed to tag your contribution with the label hacktoberfest-accepted . Or, add the ‘hacktoberfest’ topic to the repository to opt the project into Hacktoberfest.

Any pull/merge request with the hacktoberfest-accepted label, submitted to any public GitHub/GitLab repository, with or without the hacktoberfest topic, will be considered valid for Hacktoberfest.

[Events] How can I host a Hacktoberfest event?

Please visit the Hacktoberfest Events page to learn how to host and register a Hacktoberfest event.

[Events] Can you help me promote my Hacktoberfest event?

Yes! We’ll use the information you provide when registering your event on the Hacktoberfest Events page to publish your event to Major League Hacking for anyone to attend.

[Events] Why organize a Hacktoberfest-themed event?

Events are a great way to increase awareness of open source in your community, giving community members an opportunity to meet maintainers, contributors, and each other.

Events provide opportunities to learn about the open-source ecosystem—from how to start an open-source project to marketing your project, sustaining growth, and troubleshooting and maintenance.

[Events] Who can organize a Hacktoberfest-themed event?

Anyone can organize an event as long as you celebrate open source during the event. Find out more about how to host and register your event on the Hacktoberfest Events page.

[Events] How can I keep my event engaging?

Whether you’re meeting virtually or in person, meetups can be challenging to facilitate, but they can still be fun! Using networking tools like Icebreaker or Kahoot for a trivia game and asking fun opener questions (such as two truths and a lie) can loosen up the crowd and get attendees ready to share their open-source knowledge.

[Events] Can I host an in-person event?

Yes! We encourage all kinds of events - whether they are virtual, in-person or a hybrid.

If you do want to hold an in-person event, there are a few things to note:

  • We will not be providing swag or event kits for in-person events held this year. Do, however, check out our Brand Kit which includes some virtual swag such as mobile or desktop wallpapers and a Git Cheat Sheet.

  • Please follow the advisory guidelines of your state and local governments about gatherings in person.

[Events] My event hasn't been approved yet. How long until it goes live?

Once you have submitted an event, the Major League Hacking events team will review your listing within 1-2 business days. If any changes need to be made, you will be alerted and the review process will start over. Please note: if you submit your event within two days of the event start and that coincides with a weekend, we cannot guarantee that the event will be approved in time.

[Troubleshooting] Why aren’t my draft pull/merge requests counting toward Hacktoberfest?

For Hacktoberfest, pull/merge requests on GitHub/GitLab will not be counted until they are marked as ready for review: Those marked as draft will not be counted.

Please make sure to mark any draft pull requests as ready for review so that project maintainers can merge them.

[Troubleshooting] Why is my pull/merge request in a maturing state on my profile?

In an effort to reduce spam and help maintainers, all pull/merge requests go through a week-long approval period for Hacktoberfest. This provides a buffer window for maintainers where they can change their decision on a pull/merge request that they may have accepted, and gives our team time to review and tackle spam across the whole program. No action should be required by you, your pull/merge request will automatically count toward your Hacktoberfest progress once the seven days elapse, as long as it is still accepted by the project maintainers and follows Hacktoberfest’s rules.

[Troubleshooting] My PR/MR was labeled as invalid/spam, but it isn’t. What should I do?

If a maintainer labels your pull/merge request as invalid or spam, but you don’t believe this is correct, please begin a conversation with the maintainer of the PR and respectfully explain your position. Understand that it is ultimately up to the maintainer whether or not they think your PR/MR is legitimate, and you should respect their decision after discussing it with them.

[Troubleshooting] If I made 4 pull/merge requests before October but they were merged during October, will they count towards my goal?

No. All pull/merge requests made before the start of Hacktoberfest, September 30 at 10:00 AM UTC, will not count.

[Troubleshooting] What happens if I make a pull request before the maintainer adds a hacktoberfest topic to the repository?

We continually check the validity of your pull/merge requests, so as soon as a maintainer opts-in the project, we’ll see this has happened and start processing your pull/merge request fully. Once we’ve seen that your PR/MR is in an opted-in project, we won’t check this again, so don’t worry if a maintainer later removes the topic again, your PR/MR will still count.

[Troubleshooting] Why hasn’t my PR/MR appeared on my profile, or updated into the correct state?

Hacktoberfest refreshes user profiles automatically in the background every six hours, fetching the latest data for all your pull/merge requests and processing them to ensure they’re in the correct state, before then processing your account itself to ensure you’re in the correct state and have the correct rewards.

When you load your Hacktoberfest profile, we’ll also attempt to refresh your profile in the background, at a maximum rate of once every 15 minutes. Once you’ve loaded your profile to trigger this background processing, you may need to reload your profile again after a few minutes to see the updated data.

If you make changes to a PR/MR that will affect its standing for Hacktoberfest in the final six hours of the event, you will need to load your profile and ensure the changes are reflected there, as there will be no further automatic background jobs to catch the changes.

[Troubleshooting] Why aren’t my contributions in an SSO-protected organization updating?

Due to limitations in how GitHub handles SSO-protected organizations, even if a repository is public, accessing it requires a valid SSO session if you are a member of the organization. This same restriction extends to OAuth applications, such as Hacktoberfest, so we cannot automatically fetch SSO-protected contributions for you if you do not have an active SSO session.

To ensure that your contributions to public repositories in an SSO-protected organization that you are a member of are tracked for Hacktoberfest, first ensure that you are signed into GitHub and have an active SSO session for the organization, such that you can access the PR/MR yourself. With the active SSO session in GitHub, load your Hacktoberfest profile to trigger a background refresh of your profile, which should allow us (via our OAuth app) to fetch the latest data for the PR/MRs.

[Maintainers] As a maintainer, how do I encourage contributions to my repos?

First, classify your repository with the hacktoberfest topic. This will let participants know that your repo is participating in Hacktoberfest. Check out this video on how to apply the hacktoberfest topic to your repository.

You can also create issues for anything you’d like contributors to help with, and you can add labels like good first issue and help wanted so they’re easier to discover.

[Maintainers] As a maintainer, how should I handle spam pull/merge requests?

We dislike seeing spam pull/merge requests just as much as you, so please give them a spam label and close them. Pull/merge requests that have a label containing the word spam won’t be counted toward Hacktoberfest, and participants with two or more PR/MRs identified as spam will be disqualified.

[Maintainers] As a maintainer, do I earn a digital reward for participating in Hacktoberfest?

Whether you are a maintainer, contributor or event organizer, you are eligible to unlock the digital badges as your four pull/merge requests are accepted. Unfortunately, we won’t be rewarding maintainers for completing maintainer actions such as reviewing pull/merge requests this year, only for submitted accepted PR/MRs.

[Maintainers] How can I exclude my repository from Hacktoberfest?

Hacktoberfest is an opt-in system for maintainers. Repositories must have the hacktoberfest topic to opt-in and have PR/MRs be counted, or individual PR/MRs can be labeled with the hacktoberfest-accepted label. Any repository without the hacktoberfest topic, and not using the label, is automatically excluded, no action required.