├── LICENSE └── README.md /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2024 Hack Club 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 | # 𝒯𝒽𝑒 𝒜𝓇𝒸𝒶𝒹𝑒 𝒞𝑜𝓃𝓈𝓉𝒾𝓉𝓊𝓉𝒾𝑜𝓃 2 | 3 | Arcade is a game where you get prizes for building, documenting, and shipping projects. 4 | 5 | The spirit of Arcade is for you to build stuff in a hacker mindset. Start a project, push it to an MVP as fast as possible, publish it, then iterate quickly. We have rules and standards for review, but the ultimate thing those rules are trying to get at is "are you doing real work on personal projects in a hacker mindset". 6 | 7 | This is the first draft of a living document defines "what counts" for the Hack Club Arcade. It should be a short and sweet reference for Arcade players and reviewers alike. Comments, pull requests, and questions are welcome. 8 | 9 | ## The Essential Phases 10 | 11 | Arcade has three essential phases: 12 | 13 | 1. **Build** projects and log your hours with `/arcade` 14 | 2. **Document** progress in a git-based versioning system 15 | 3. **Ship** a shareable version in #scrapbook when it's ready 16 | 17 | After you ship, you'll get a ticket for every hour that passes review. Spend these tickets with `/shop` 18 | 19 | ### What counts as a "Project"? 20 | 21 | A project is a self-directed creative effort toward an output that other people can meaningfully experience. 22 | 23 |
24 | Fine Print 25 | 31 |
32 | 33 | 54 | 55 | ### What counts as "Documenting progress"? 56 | 57 | The journey of each project must be shared in a public git repository, with at least one update committed per hour logged. 58 | 59 |
60 | Fine Print 61 | 68 |
69 | 70 | 81 | 82 | ### What counts as "Shipped"? 83 | 84 | A shipped project must be shared in a way that other people can experience to the greatest possible extent. 85 | 86 |
87 | Fine Print 88 | 94 | 95 | Some examples of "native" websites diffferent types of projects are below. Keep in mind, this isn't an exhaustive list, but a big part of "shipping" a project is getting others to experience it & this is a good way to do that. 96 | 97 | - 3D printing files 98 | - https://thingiverse.com 99 | - https://printables.com 100 | - https://makerworld.com 101 | - Blender files 102 | - https://blendswap.com 103 | - https://sketchfab.com 104 | - Games 105 | - https://itch.io 106 | - https://gamejolt.com 107 | - Web projects 108 | - https://vercel.com (if a website) 109 | - https://github.com (Using GitHub Pages) 110 | - Game mods (different for every game) 111 | - https://www.spigotmc.org (for Minecraft mods) 112 | - https://modrinth.com (for Minecraft mods) 113 | - https://hangar.papermc.io (for Minecraft plugins) 114 | - https://www.moddb.com/ (for source games) 115 | - Discord bots 116 | - https://top.gg 117 | - https://bots.ondiscord.xyz 118 | - https://discord.bots.gg 119 | 120 | ## Python Projects 121 | 122 | In particular we find python projects are often the hardest to ship. A couple approaches you can take: 123 | 124 | - If you have a package, you can publish it to PyPi 125 | - If you make a game or executable, you can publish it with pygame or pyinstaller 126 | - If all else fails, you can publish it to GitHub and include a `requirements.txt` file & a `poetry.lock` file & cut a release 127 | 128 | Many python projects end up being just a `script.py` file in a repo, which isn't a real project because it may only work on your machine. Keep in mind that the goal is to make your project accessible to others & everyone has different versions of python and different dependencies installed. 129 | 130 |
131 | 132 | 143 | 144 | ## The Essential Vibes 145 | 146 | The gray areas of "what counts" are ultimately resolved with a vibe check. Here are some vibey questions we may ask ourselves when assessing whether something counts for Arcade: 147 | 148 | - **How technical is this project?** 149 | - **Is this person pushing themselves?** 150 | - **Does this project feel wholesome?** 151 | - **Is this a highly self-directed project?** 152 | - **Is this a good story?** 153 | - **Am I amazed?** 154 | 155 | These are not criteria or requirements, they are just vibes. But when a project is in a gray zone, these vibes guide our decisions. 156 | 157 | ## Other Rules 158 | 159 | 166 | 167 | ## Happy Hacking! 168 | 169 | Build stuff, get stuff, repeat. All summer. _(ends August 31st)_ 170 | --------------------------------------------------------------------------------