Registration Administration Guide

This document explains how registration automation works in the current assignment-link model.

If you only need setup steps, use REGISTRATION-QUICKSTART.md.

Current Model

Registration automation in this repository does not require organization invitations.

What the workflow does:

• Validates registration or enrollment submissions.
• Handles duplicate and waitlist behavior.
• Posts Day 1 and Day 2 assignment links when variables are configured.
• Uses student issue comments as milestone signals:
  • ack confirms Day 1 link access.
  • day1-complete signals Day 2 release eligibility.

Required Repository Variables

Set these in Community-Access/git-going-with-github:

• CLASSROOM_DAY1_ASSIGNMENT_URL
• CLASSROOM_DAY2_ASSIGNMENT_URL

Optional operational variables:

• ENABLE_PUBLIC_REGISTRATION_EXPORT
• ENABLE_PUBLIC_CLASSROOM_INTAKE_EXPORT
• PRIVATE_STUDENT_DATA_REPO

Required secrets for private data and dashboard workflows are unrelated to org invites:

• PRIVATE_STUDENT_DATA_TOKEN
• INSTRUCTOR_DASHBOARD_TOKEN (if using dashboard sync)

End-To-End Verification

Run this checklist before go-live:

1. Submit a test enrollment issue from a test student account.
2. Confirm welcome comment includes Day 1 link.
3. Reply ack as the test student.
4. Reply day1-complete as the test student.
5. Confirm Day 2 is unlocked comment appears.
6. Confirm labels are applied as expected: enrolled, day2-eligible, day2-released.
7. Submit a duplicate registration and confirm duplicate-close behavior.

Rollback

If assignment posting is incorrect, keep registration running and temporarily disable links:

1. Clear CLASSROOM_DAY1_ASSIGNMENT_URL, or
2. Clear CLASSROOM_DAY2_ASSIGNMENT_URL.

Registration, duplicate handling, waitlist behavior, and private intake storage will continue.

Student Interaction Contract

Students should be told to follow this sequence:

1. Submit enrollment issue.
2. Open Day 1 assignment link from the bot comment.
3. Reply ack after verifying access.
4. Reply day1-complete when Day 1 milestone is done.
5. Open Day 2 assignment link from the release comment.

Privacy Notes

• Registration issues are public in this repository.
• Public issue bodies are redacted for enrollment fast-path.
• Full intake details are stored in the private administration repository.
• CSV exports are artifact-based and controlled by explicit flags.

Authoritative Sources

Use these official references when you need the current source of truth for facts in this chapter.

• GitHub Docs, home
• GitHub Changelog
• GitHub Discussions docs
• GitHub Gists docs

Section-Level Source Map

Use this map to verify facts for each major section in this file.

• Current Model: GitHub Docs, home, GitHub Changelog, GitHub Discussions docs, GitHub Gists docs, GitHub Copilot docs
• Required Repository Variables: GitHub Docs, home, GitHub Changelog, GitHub Discussions docs, GitHub Gists docs, About Git
• End-To-End Verification: GitHub Docs, home, GitHub Changelog, GitHub Discussions docs, GitHub Gists docs
• Rollback: GitHub Docs, home, GitHub Changelog, GitHub Discussions docs, GitHub Gists docs
• Student Interaction Contract: GitHub Docs, home, GitHub Changelog, GitHub Discussions docs, GitHub Gists docs, Workflow syntax for GitHub Actions
• Privacy Notes: GitHub Docs, home, GitHub Changelog, GitHub Discussions docs, GitHub Gists docs