Introduction

Hi ๐Ÿ‘‹ Welcome to the Open Source Raid Guild โš”๏ธ

Find Target ๐ŸŽฏ Communicate ๐Ÿ›ฐ๏ธ Raid โš”๏ธ Push Code ๐ŸŽ‰

All Contributors

The OSS Raid Group is what happens when you combine MMORPGs (Gamification), Mob Programming, Crowdsourcing, and Open Source Software - a group dedicated to defeating the Raid Bosses of OSS!

For those who arenโ€™t aware of these โ€˜gamerโ€™ terms, and even those that are; here are the definitions we use when operating as a Raid Guild.

PhraseDefinition
RaidA Raid is the OSS projectโ€™s issue that we are working to resolve - see how we converted react-hooks-testing-library to TypeScript for an example
Raid BossThe Raid Boss is the large issue/problem domain that we are โ€˜fightingโ€™ to resolve
Open Source Raid Guild (OSRG)The collective noun for all contributors to the Raid
Raid RepoThe repository for the current Raid that has been forked into the OpenSourceRaidGuild Org
DungeonThe working fork repository that the Raid is operating inside of; multiple Raids can occur in one Dungeon but only one Raid at a time

Storyline Quest (mission) ๐Ÿ“œ

Objectives:

  • To make contributing to OSS enjoyable, engaging, and with a low barrier-to-entry for those who have never done it before
  • To have a high impact in a small amount of time; specifically targetting low-medium contributor activity, medium-high usage of the project, with only a handful of maintainers

What itโ€™s about:

  • Itโ€™s about winning the Raid as a group, not about who made the biggest contribution(s).
  • Itโ€™s about learning together; teaching each other, flattening the learning curve.
  • Itโ€™s about having fun and getting into something you may not have done on your own.
  • Itsโ€™s about lowering or even removing the bar of entry for OSS contributing for everyone.
  • Most of all it is about having FUN!

Join Us! ๐Ÿฅฐ

Anyone is welcome to participate in our Raids - no matter your experience level! Never contributed to an OSS project? No worries! We are all learning something or another, so come along for the ride!

Intake Quests

  1. Say hello to your fellow Guild Members in Discord
  2. Jump into a Raid, and start contributing!

Advancements

When you are:

  • Actively contributing to Raids
  • Being an active community member on the OSRG Discord Server

Then we can determine responsibilities and get you running as either an outside collaborator on new Raids, eventually becoming a member on the Raid Org

Raids โš”๏ธ

  • One Raid at a time to maximize impact in a short amount of time.

Communication ๐Ÿ›ฐ๏ธ

  • We primarily communicate via Discord
  • Guild Roles are assigned to individuals based on time, activity in Raids and contributions to OSRG as a whole, everyone starts off as an Guild Initiate who joins.

Workflow

When participating in a Raid, use the following steps.

  1. Raise an issue in the Raid repo with a one-liner title describing what you are working on - for example Migrate page-header/breadcrumbs tests to testing-library
  2. Fork the Raid Repo (Raid Git Workflow)
  3. Create a branch named after your GitHub username - e.g. nobrayner
  4. Hack away ๐Ÿ˜Ž๐Ÿ’ป
  5. Create a PR titled the same as your issue, and a description of Fixes #{ISSUE_NO} - like this PR for example