Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/github/hackathons

Tips, Tricks, and Resources for running your hackathon.
https://github.com/github/hackathons

community discussions hackathon hackathon-organisers hackathon-starter hackathons hacktoberfest hacktoberfest-accepted organiser

Last synced: about 1 month ago
JSON representation

Tips, Tricks, and Resources for running your hackathon.

Awesome Lists containing this project

README 

        
![Hackathon Logo](https://user-images.githubusercontent.com/36594527/117592199-10730800-b17b-11eb-84f8-4ffcae8116d4.png)



# 
 JOIN A COMMUNITY CONNECTED BY CODE 



This repository contains Tips, Tricks, and Resources to help you plan, organise, and execute your hackathons. Hopefully you'll find these useful when planning your next hackathon.



There are three main sections in this repository:



🔮 [Tips and Tricks](https://github.com/github/hackathons/blob/main/TipsandTricks.md)



📚 [Resources](https://github.com/github/hackathons/blob/main/Resources.md)



📣 [Discussions](https://github.com/github/hackathons/discussions/1)



Guidelines are detailed below on how to contribute to each of these documents. If there are any issues within this repo you'd like to flag, please [open an issue](https://github.com/github/hackathons/issues/new?assignees=MishManners&labels=&template=IssueFeatureBug.md&title=%3Azap%3A+Request+to+add+tip+or+trick+to+documentation+%3Abug%3A+).



### Participating in a hackathon



Please note this repository is **NOT** geared towards participants. This repository contains information and guides for 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, and you want some guidance you can check out the following sites:

- [Major League Hacking](https://mlh.io/)

- [DevPost](https://devpost.com/)

- [Hackathons International](https://www.hackathonsinternational.com/)

- [Hackaday](https://hackaday.com/)

- [DevFolio](https://devfolio.co/hackathons)

- [Hack Club](https://hackathons.hackclub.com/)

- [HackaList](http://www.hackalist.org/)

- [AngelHack](https://angelhack.com/hackathons/)

- [Hackathon IO](https://www.hackathon.io/)

- [Game Jams](https://itch.io/jams)



**Tip for organisers**: the above sites are great places where you can promote your hackathon!



## 🔮 [Tips and Tricks](https://github.com/github/hackathons/blob/main/TipsandTricks.md)



The [Tips and Tricks file](https://github.com/github/hackathons/blob/main/TipsandTricks.md) contains lots of information on how to run your hackathon. Whether you're thinking about running an in-person, online hackathon, or hybrid hackathon, this document will help you answer some of your questions.



You can [download](https://github.com/github/hackathons/files/6497549/GitHub.Hackathon.Tips.and.Tricks.2020.pdf) 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](https://github.com/github/hackathons/discussions/categories/tips-and-tricks) 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 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](https://github.com/github/hackathons/blob/main/Resources.md)



Organisers are often looking for good resources for running their hackathons. The [Resources file](https://github.com/github/hackathons/blob/main/Resources.md) contains a list of useful resources for you to consult. There's everything 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 the [Resources file](https://github.com/github/hackathons/blob/main/Resources.md), please [open a pull request](https://github.com/github/hackathons/pulls). Ensure your resource recommendation includes:

- Name of the resource

- Link to the resource (ie. website)

- Short description of the resource



See the [Resources document](https://github.com/github/hackathons/blob/main/Resources.md) 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 may be rejected.



You can also [head to the Discussions](https://github.com/github/hackathons/discussions/categories/resources) to talk about certain resources before adding them to the documentation.



## 📣 [Discussions](https://github.com/github/hackathons/discussions/1)



This is a great place to connect to other hackathon organisers. You can use the [Tips and Tricks](https://github.com/github/hackathons/discussions/categories/tips-and-tricks) or [Resources](https://github.com/github/hackathons/discussions/categories/resources) Discussions before adding content to this repository. You can also share [ideas](https://github.com/github/hackathons/discussions/categories/ideas), talk about [random things](https://github.com/github/hackathons/discussions/categories/general), or [ask questions](https://github.com/github/hackathons/discussions/categories/q-a).



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. Remember, constructive thoughts and feedback is good, just please always be mindful not to shut people down or discourage other members of the community.



_______



#### Made with ❤️ by GitHub and friends