Hacktoberfest Maintainers Guide

[AceTheCreator]

AsyncAPI Hacktoberfest 2022 Participation

Glad to announce that AsyncAPI will be participating in this year's (2022) hacktoberfest like we've done in previous years, and now is the perfect time to start hacking with us!

Why Hacktoberfest

By now you have hopefully heard of Hacktoberfest, an initiative that encourages everyone to contribute to open source projects in the month of October. By making 5 pull requests to open source repositories on GitHub, participants can earn a special T-shirt, prestige, and the feeling that they contributed to a more open world.

Getting started

As a maintainer, if your project has issues that you feels should be fix this month, please kindly add the hacktoberfest label when submitting the issue

Leave the quick fix for the participants

When you spot a quick fix it is tempting to just make the change and be done with it. However, if you label an easy issue “Good First Issue” you will encourage more new people to work on it and grow the community.

Repo tideness

Before you start accepting a bunch of pull requests for Hacktoberfest, take a moment to clean up your repository. Are there a bunch of old issues that could be closed? Are there PRs waiting to be merged?

Spending a few minutes ensuring your project is clean and ready to go will make it a lot easier to accept new PRs.

Ensuring the README is beginner friendly

Go through the readME file and ensure it's well laid out so that first-time contributors wouldn't have to struggle setting it up locally and edit the project.

Topic/Labels

As part of Hacktoberfest and to make it easy for contributors to spot these projects, the repository should have one or more of the following labels. They're tons of issues on GitHub with the hacktoberfest label already, and folks will be actively searching for them.

• hacktoberfest(mandatory)
• good-first-issues

For good-first-issue use our bot automation by adding a comment to the issue like /gfi javascript that will add good-first-issue and area/javascript labels to the issue. You can always ask the bot for help by writing a comment /help in your issue.

Please, remember to add hacktoberfest topic to the repo. Also, kindly remove one if you do not want your repo to be involved.

The properly hacktoberfest-labeled issue will be visible in this list.

Engage with PRs and Contributors

When participants see that the maintainers are actively merging pull requests they will be more likely to make one themselves. Try to set aside a few minutes every day to do some merges.

Seek help

Let them know you are looking for help. When you see repeat contributors, consider giving them more responsibility, and asking them to review PRs. Remember, you don’t have to be alone on your open-source journey. Easily tag @AceTheCreator and @derberg if you need any help at all because they'll always be on standby :)

Take some alone time

Your project is awesome and you love it. But it’s okay to take a break sometimes too. As a maintainer, you run the project, it doesn’t run you. And feel free to reach out to other maintainers interested in stepping up for you while you're away :)

Office hours

@AceTheCreator and @derberg will host office hours for Hacktoberfest participants under a live stream called Let's talk about contributing. These live streams will take place every week until the end of October. If you want to join these, contact the hosts.
First live stream is already scheduled for this Wednesday.

---

• pinging @asyncapi/tsc_members so you are aware.
• pinging some maintainers that did not join TSC -> @mr-nuno @connil @leigh-johnson @gutee @jstoiko @looseale