mirror of
https://github.com/github/Research-Panel-Sweepstakes
synced 2026-07-23 18:33:43 +00:00
No description
- Python 100%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
468e211744Replace per-study CELA review with an automated conformance gate. Every PR that adds or edits an Official Rules document is validated against the CELA-approved canonical template (Open Source Community Happiness Study 2026). If only the allowed per-study fields changed and the legal boilerplate is intact, the check PASSES and no fresh CELA review is required; any deviation FLAGS the PR for CELA. - scripts/validate_official_rules.py: fuzzy token-containment validator (PDF/MD/TXT), tolerant of PDF OCR glitches; checks required sections, boilerplate anchors, critical terms, prohibited paid-entry/"raffle" language, and per-study fields. - templates/rules-spec.json: machine-readable conformance spec. - templates/official-rules-template.md: fill-in-the-blanks canonical template. - .github/workflows/validate-official-rules.yml: runs on rules-doc PRs, posts a PASS/FLAG comment, and sets the check status as the gate. - README.md: documents the gate and reframes the process around the pre-cleared template. Validated against all 8 existing rules docs: 6 current-format docs PASS; the Developer Sustainability and older Universe docs FLAG (genuine deviations). Copilot-Session: c68cc38e-09d4-4548-8cb7-f5ce653047ce Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> |
||
| .github/workflows | ||
| scripts | ||
| templates | ||
| Copilot Coding Agent Churned and Unengaged Survey Sweepstakes Official Rules 2025.pdf | ||
| Copilot Coding Agent Survey Sweepstakes Official Rules 2025.pdf | ||
| Copilot Workspace Churn Survey Sweepstakes Official Rules 2025.pdf | ||
| Copilot Workspace Survey Sweepstakes Official Rules 2025.pdf | ||
| folder | ||
| GitHub Copilot App Survey Sweepstakes Official Rules 2026.pdf | ||
| GitHub Developer Sustainability Survey Sweepstakes Official Rules 2026.pdf | ||
| GitHub Universe Customer Research Sweepstakes Official Rules.docx.pdf | ||
| Open Source Community Happiness Study Sweepstakes Official Rules 2026.pdf | ||
| README.md | ||
Research-Panel-Sweepstakes
How to Conduct a Research Sweepstakes
- Download or make a copy of an existing Sweepstakes Official Rules document. The Open Source Community Happiness Study Sweepstakes Official Rules is the pre-cleared template to work from. A plain-text version with fill-in placeholders lives at
templates/official-rules-template.md. - Rename the document to a title relevant to your study and edit only the customizable fields: entry period timing, eligibility audience, link to the study, incentive amount, and winners list. Leave all other legal language exactly as written. Comb through the language carefully — a second pair of eyes is recommended.
- Open a pull request that adds your document to this repository (instead of committing straight to
main). The Official Rules Review Gate runs automatically and posts a PASS or FLAG comment. Navigate to the repository's main page, click the Add file dropdown button, then select Upload files, drag and drop your document, and choose "Create a new branch and start a pull request." - Add the appropriate verbiage to your survey or email copy, such as: "For official sweepstakes rules, please see the following details here."
- Link the new file to your survey or email copy using the URL from your browser. Make sure you are linking the correct file for your specific study.
Agent Review Gate (replaces per-study CELA review)
The Official Rules are pre-cleared legal boilerplate plus a small set of per-study fields. An automated gate (.github/workflows/validate-official-rules.yml) checks every Official Rules document added or edited in a pull request against the approved template:
- ✅ PASS — you changed only the allowed per-study fields and left the boilerplate intact. No fresh CELA review is required; you can publish.
- 🚩 FLAG — the document changed fixed legal language, dropped a required section, is missing "No Purchase Necessary", uses a prohibited word ("raffle"/"lottery"), or signals a paid entry. Route to CELA for review before publishing, or fix the document to match the template.
Allowed per-study fields: title, entry period start/end, eligibility audience, survey/study URL, prize description and ARV, number of winners, and the Winners List contact/subject/window.
Fixed (do not edit): Sponsor, Definitions, the employee-exclusion and "Void in …" sentences, "No Purchase Necessary", winner-selection mechanics, prize warranty/substitution/tax language, Odds, Release of Liability, Use of Your Entry, and Governing Law.
The conformance rules are defined in templates/rules-spec.json. To check a document locally: python scripts/validate_official_rules.py "Your Rules 2026.pdf".
Watch Outs
- Double-check all customized fields (entry period, eligibility, study link, incentive amount, winners list). Review the document multiple times.
- Make sure to pay the winner within the timeline specified in your rules.
- Participants may reach out to find out who won, so have that information ready and ensure you've listed yourself as the point of contact in the Winners List section.