JOIN A COMMUNITY CONNECTED BY CODE
This repository contains Tips, Tricks, and Resources to help you plan, organise, and execute your hackathons. You can use these to help guide you when planning your next hackathon.
There are three main sections to this repository:
Guidelines are detailed below on how to contribute to each of these documents. If there are other issues you'd like to flag, please open an issue.
Participating in a hackathon
Please note this repository is NOT geared towards participants. This repository contains information useful to hackathon organisers and managers. It does not contain tips/tricks or resources for participating in a hackathon. If you are looking for a hackathon to participate in, you can check out the following sites:
- Major League Hacking
- DevPost
- Hackathons International
- Hackaday
- DevFolio
- Hack Club
- HackaList
- AngelHack
- Hackathon IO
Organisers, the above sites are great places where you can promote your hackathon!
🔮 Tips and Tricks
The Tips and Tricks file contains lots of information on how to run your hackathon. Whether you're thinking about running an in-person or online hackathon, this document will help you answer lots of questions you'll be asking.
You can download this document as a PDF. Feel free to use it, share it around, and consult it.
Contribution Guidelines
If you have new ideas you'd like to add to the Tips and Tricks document, please head to the Discussions and start a conversation. If your tip or trick gets a lot of attention, we'll consider adding it to the documentation!
When talking about tips and tricks, ensure that your additions/changes include information that is useful for hackathon organisers. If your addition or change does not include enough information or is not geared towards hackathon organisers, then your change will probably not be included. Remember, this repository is for hackathon organisers, not participants.
We're opted in for Hacktoberfest, so please feel free to contribute based on the guidelines here
📚 Resources
Organisers are often looking for good resources for running their hackathons. The Resources file contains a list of useful resources for you to consult. There's everything here from platforms to host your hackathon, promotion sites, judging recommendations, communication tools, and more.
Contribution Guidelines
If you would like to add a resource to this document, please open a pull request. Ensure your resource recommendation includes:
- Name of the resource
- Link to the resource (ie. website)
- Short description of the resource
See the Resources document to see how other resources are displayed. Please follow this format otherwise your pull request could be rejected. Ensure your resource is placed in the correct alphabetical order.
Format for adding your resource:
[Name of the Resource in H2 format](with link to website)
Short description, between two and four sentences long. Talk about what the resource is and how it can help organisers. Ensure the link above includes https instead of http.
# you can add an appropriate gif, short video, or image if it suits. However, this is not necessary.
Remember, this resource is for organisers, not participants. If your resource is not for organisers and does not meet the requirements above, your pull request could be rejected.
You can also head to the Discussions to talk about Resources before adding them to the documentation.
📣 Discussions
This is a great place to connect to other hackathon organisers. You can use the Tips and Tricks or Resources Discussions before adding content to this repository. You can also share ideas, talk about random things, or ask questions.
This is an open community so feel free to answer any of the questions in the Discussions, comment on other people's threads, and share your own ideas too. Remember, constructive thoughts and feedback is good, just please always be mindful not to shut people down or discourage members of the community.
Made with ❤️ by GitHub and friends
