Teaching coding is hard. Running engaging Hack Club meetings is even harder.
What better way to "crack" the workshop format than get every Hack Club leader in the world involved?
This semester, if you contribute a workshop to https://workshops.hackclub.com, we'll pay you $200. You could write workshops instead of a part-time job for personal income. Or you could write workshops to fundraise for your club.
What a great workshop looks like:
Great workshops make a real project in under 20 minutes, are very visual, and have clear paths for continued hacking. Members should be inspired to keep hacking on the project after the workshop, not left feeling stuck without knowing what to do next.
In the past, Hack Club workshops were all Markdown files formated like blog posts. We want to push the format and will be accepting interactive MDX files, slideshows, static websites, and more (regular Markdown is still OK!).
</body>tag", code blocks that include new lines of code being shown in their entirety, and a constant reminder of what the current code should look like, all make sure the person going through the workshop is never lost. Any code concepts or information about a library are made optional to learn more by clicking a link.
![A close-up of a gecko foot being pressed on glass](https://mbs.zone/geck)
Hack Club workshops are entirely open source on GitHub. Workshops are submitted using pull requests.
In addition to submitting the workshop itself, we ask that you test your workshop in a club meeting and record a 1-2 minute clip during the meeting showing what people built. You could turn on Zoom recording for 2 minutes near the end of the meeting. Or walk around with your phone's camera showing what people built if you're in-person. This meeting can be a real club meeting or a mock meeting where you gather 3+ friends.
Every workshop we accept as part of the workshop bounty program should be something we're proud to stand by as official Hack Club curriculum. If any of the above requirements are not hit, we will ask you to resubmit once you've met all guidelines. If this is your first time submitting a workshop, your submission will likely be rejected multiple times before it's ready to merge. Writing a good workshop is very challenging, and although we are a very small team and we can't promise that we'll be able to provide detailed editing and feedback on submissions, we will work with you to get your workshop in a good spot.
How to submit:
Create a pull request to
hackclub/hackclub on GitHub with a new folder in the
workshops/ directory called the name of your workshop. Make sure to follow the lowercase snake case format, like the other workshops. Put your workshop in a file named
If your workshop is a slideshow or another binary format, export it and upload to the
#cdn channel on the Hack Club Slack. Then link it from
At the top of the file, include the following metadata (author being your GitHub @username):
--- name: 'Sound Galaxy' description: 'Visualize sound by making particles move in a galaxy' author: '@MatthewStanciu', img: 'link-to-image-summarizing-your-workshop' ---
Upload your meeting recording to the
#workshop-skunkworks channel on Slack.
Copy the link to the Slack message containing your recording and include it in the text of your pull request.
Submit! If you have questions about submission, please ask in
#workshop-bounty on Slack
How to get your payment:
Once your pull request is merged, you'll be sent a private form to share your payment details and tax forms with us.
You will receive a screenshot confirming payment once it's been made, usually within 7 days of form submission. Checks can take up to 2 weeks to arrive.
This is a very new experiment. We'll be iterating on the workshop guidelines throughout the semester and working to make sure that everyone is having the best experience possible.
If you have any questions, please message in
#workshop-bounty on Slack. I'll be hanging out there to help out.
Earlier I mentioned that running a club was hard. During the first 6 weeks of this school year, I am personally onboarding every new Hack Club myself.
I'm also speaking with many folks about their own Hack Clubs, some who are close to HQ and some who are not so close, and sharing excerpts below (with permission, of course).
Bloomington, IN. 2:59 PM on Thursday, September 3rd, 2020.
What makes a good Hack Club meeting?
A lot of it is the leader. The leader has to provide the energy and make sure people are having fun. It is important that people learn stuff, but it may be even more important that people have fun than actually learn stuff. That doesn't mean people shouldn't learn stuff, just that it's really important they have a good time. One of the best ways to make sure people have a good time is to have them making some real while having fun.
You ran your Hack Club for 4 years. You mentioned that when you were a freshman and starting out, it was bad. Only later in your junior and senior years you feel like you "cracked" the format and started consistently running good meetings that had regular high attendance. What was the difference between your club when it was bad vs. good?
When it was bad, we mostly did nothing. During meetings, I would say: "OK, everyone can do whatever they want. Let me know if you need help thinking of a project." But really people just got lost and nobody asked for help. I was also working on my own projects during club meetings, which a lot of club leaders do. I thought that would inspire my members to build projects of their own, but in retrospect I think it just made me less approachable.
As soon as I stopped working on my own projects and got up and spent the whole meeting walking around the room, being energetic, checking in, and asking people if they needed help, I could feel a huge difference. Truly nobody in your club is going to ask for help, especially if they think you're busy. Admitting they need help makes them feel weird because they feel like they're bothering you. You have to check in with your members if you want them to ask you for help.
My Hack Club actually became good when I was running content every week. Because there wasn't good content available via the Hack Club workshops, I started writing my own workshops each week for club meetings.
What was the difference between the bad and the good workshops you made?
Usually the bad workshops, well—none were really bad—but the worst ones were the ones where the end result wasn't very satisfying or people had to spend too much time writing too much code that they didn't understand to get something tangible.
The best ones were where the end product was something really, really cool, visually appealing, and made in 10 or 20 minutes. Also, the best ones had 5 examples right out of the gate of how other people have hacked it. Then people would do the workshop and at the end everyone would end up with something different.
For members, good workshops take very little time and effort to produce something very visually appealing and very hackable. And there are inspiring examples of how the workshop could be further hacked.
A lot of the old Hack Club workshops felt more like tutorials than workshops. Because people spent 45 minutes going through the tutorial and then making something that they didn't feel very satisfied by. Synth was the best workshop not made by me because it was very satisfying, but even it took an hour to do and that was too long for a good club meeting.
My favorite workshop I've made is Sound Galaxy. Most people, especially beginners, don't know that it's actually possible to take input from your microphone and turn it into colorful blops that show up on the screen with input from your microphone. And it's even more impressive you can do that as a complete beginner and newbie in 40-50 lines of code. Every member I've seen do that workshop was very impressed that it was possible to make something so cool that they didn't even know was possible in such a short amount of time.
Thanks to Christina Asquith, Claire Wang, Lachlan Campbell, Malte Lauterbach, Matt Gleich, Matthew Stanciu, Max Wofford, Sam Poder, and other Hack Clubbers in the community for their feedback on this post.Edit on GitHub