How to Contribute
As part of ECSOC, we are introducing ECSOC Sentinel, the official pull request scoring automation system. This system ensures fair, transparent, and consistent evaluation of all contributions across participating repositories.
To enable automated scoring for your project, the following steps are mandatory.
Step 1: Install the GitHub App
- 1Open the following link: github.com/apps/ecsoc-sentinel
- 2Click Install.
- 3Select Only select repositories.
- 4Choose the repository that is participating in ECSOC.
- 5Complete the installation.
Step 2: Use the Required Label on Pull Requests
For a pull request to be considered for scoring, it must include the following label:
This label can be added:
- Before merging the pull request, or
- At the time of merging.
Pull requests without this label will not be processed by the system.
How PR Scoring Works
- Once a pull request with the ECSoC26 label is merged:
- ECSOC Sentinel automatically detects the merge.
- The PR is evaluated based on effort, impact, and quality.
A difficulty level is assigned:
The corresponding label is then applied automatically:
The contributor's points are automatically updated on the public leaderboard.
No manual review or intervention is required.
Bonus XP
Project Admins (PAs) can award additional Bonus XP by applying one of the following labels to a merged pull request:
| Label | Bonus XP |
|---|---|
| good-issue | +10 XP |
| good-pr | +15 XP |
| good-ui | +25 XP |
| good-backend | +50 XP |
Note: Bonus labels can only be assigned by Project Admins (PAs) and should be used for contributions that go beyond the expected scope of a regular pull request.
Important Notes
- The app does not modify your repository code.
- It only reads pull request metadata and applies labels.
- Scoring is fully automated, rule-based, and auditable.
- Please ensure the app is installed before contributors start submitting pull requests.
For any installation or labeling issues, contact the ECSOC Core Team.