feat: add duplicate detection, capacity enforcement, and waitlist to registration

- Detect duplicate registrations and close with friendly message
- Add capacity check (75 max) with waitlist label for overflow
- Deduplicate CSV export by GitHub username
- Update welcome message with custom text
- Add duplicate warning to issue template
- Registration page dynamically switches to waitlist mode when full
- Polish language across all scenario paths
- Remove recursive trigger (labeled event) that caused workflow failures

Author: accesswatch

.github/ISSUE_TEMPLATE/workshop-registration.yml

@@ -14,6 +14,8 @@ body:
         **Cost:** Free
         **Capacity:** 75 participants
 
+        **Important:** Please submit this form only once. If you have already registered, you do not need to register again - your spot is saved. Duplicate registrations will be automatically closed.
+
         Filling out this form is your first GitHub interaction - and it counts. You are already learning. All fields below are accessible with NVDA, JAWS, and VoiceOver.
 
   - type: input

.github/workflows/registration.yml

@@ -2,7 +2,7 @@ name: Registration - Welcome & CSV Export
 
 on:
   issues:
-    types: [opened, edited, labeled]
+    types: [opened]
   workflow_dispatch:
 
 permissions:
@@ -18,31 +18,150 @@ jobs:
       github.event.action == 'opened' &&
       contains(github.event.issue.title, '[REGISTER]')
     steps:
+      - name: Check for duplicate registration
+        id: dup-check
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const username = context.payload.issue.user.login;
+            const currentIssueNumber = context.issue.number;
+
+            // Find existing registration issues by this user
+            const existingIssues = await github.paginate(github.rest.issues.listForRepo, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              labels: 'registration',
+              state: 'all',
+              per_page: 100
+            });
+
+            const priorRegistration = existingIssues.find(
+              issue => issue.user.login === username && issue.number !== currentIssueNumber
+            );
+
+            if (priorRegistration) {
+              core.setOutput('is_duplicate', 'true');
+              core.setOutput('original_issue', priorRegistration.number);
+            } else {
+              core.setOutput('is_duplicate', 'false');
+            }
+
+      - name: Handle duplicate registration
+        if: steps.dup-check.outputs.is_duplicate == 'true'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const originalIssue = ${{ steps.dup-check.outputs.original_issue }};
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: `## You are already registered!
+
+            Hi @${context.payload.issue.user.login}, it looks like you already registered in issue #${originalIssue}. No need to register again — your spot is saved!
+
+            We have closed this issue since your original registration is already on file. If you need to update your details, please comment on your original issue #${originalIssue}.
+
+            Questions? Email [support@bits-acb.org](mailto:support@bits-acb.org).`
+            });
+
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ['duplicate']
+            });
+
+            await github.rest.issues.update({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              state: 'closed',
+              state_reason: 'not_planned'
+            });
+
+      - name: Check capacity
+        id: capacity-check
+        if: steps.dup-check.outputs.is_duplicate == 'false'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            const MAX_CAPACITY = 75;
+
+            // Count unique registered users (excluding this issue)
+            const existingIssues = await github.paginate(github.rest.issues.listForRepo, {
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              labels: 'registration',
+              state: 'all',
+              per_page: 100
+            });
+
+            const currentIssueNumber = context.issue.number;
+            const uniqueUsers = new Set();
+            for (const issue of existingIssues) {
+              if (issue.number !== currentIssueNumber) {
+                uniqueUsers.add(issue.user.login);
+              }
+            }
+
+            const currentCount = uniqueUsers.size;
+            core.setOutput('count', currentCount);
+
+            if (currentCount >= MAX_CAPACITY) {
+              core.setOutput('is_full', 'true');
+            } else {
+              core.setOutput('is_full', 'false');
+            }
+
+      - name: Handle registration full
+        if: steps.dup-check.outputs.is_duplicate == 'false' && steps.capacity-check.outputs.is_full == 'true'
+        uses: actions/github-script@v7
+        with:
+          script: |
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: `## Registration is currently full
+
+            Hi @${context.payload.issue.user.login}, thank you for your interest in GIT Going with GitHub! Unfortunately, all 75 spots have been filled.
+
+            We have added you to the waitlist. If a spot opens up, we will let you know right here on this issue.
+
+            Questions? Email [support@bits-acb.org](mailto:support@bits-acb.org).`
+            });
+
+            await github.rest.issues.addLabels({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              labels: ['waitlist']
+            });
+
       - name: Post welcome comment
+        if: steps.dup-check.outputs.is_duplicate == 'false' && steps.capacity-check.outputs.is_full == 'false'
         uses: actions/github-script@v7
         with:
           script: |
             await github.rest.issues.createComment({
               owner: context.repo.owner,
               repo: context.repo.repo,
               issue_number: context.issue.number,
-              body: `## You are registered for GIT Going with GitHub!
+              body: `## Welcome to GIT Going with GitHub!
 
-            Welcome, @${context.payload.issue.user.login}! Your registration has been received.
+            Hi @${context.payload.issue.user.login}, thank you for registering! We are excited to have you join us.
 
-            **Workshop details:**
-            - **Dates:** Saturday, March 7 & Sunday, March 8, 2026
-            - **Time:** 12:00 PM - 8:00 PM Eastern (both days)
-            - **Location:** Online via Zoom (link will be emailed before the event)
+            Your registration has been confirmed. Additional information, including the Zoom link and pre-workshop preparation materials, will be sent to you soon.
 
-            **What to do next:**
-            1. Complete the [Pre-Workshop Setup Guide](https://bits-acb.github.io/git-going-with-github/docs/00-pre-workshop-setup.html) before March 7
-            2. Questions? Email [support@bits-acb.org](mailto:support@bits-acb.org)
+            In the meantime, if you have any questions, feel free to email us at [support@bits-acb.org](mailto:support@bits-acb.org).
 
-            You just filed a GitHub issue - your first open source contribution. Welcome to the community.`
+            See you on March 7! Welcome aboard.`
             });
 
       - name: Add registration label
+        if: steps.dup-check.outputs.is_duplicate == 'false' && steps.capacity-check.outputs.is_full == 'false'
         uses: actions/github-script@v7
         with:
           script: |
@@ -62,7 +181,9 @@ jobs:
     runs-on: ubuntu-latest
     if: >-
       (github.event_name == 'workflow_dispatch') ||
-      (github.event_name == 'issues' && contains(github.event.issue.title, '[REGISTER]'))
+      (github.event_name == 'issues' &&
+      github.event.action == 'opened' &&
+      contains(github.event.issue.title, '[REGISTER]'))
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
@@ -118,10 +239,18 @@ jobs:
 
             let csv = headers.join(',') + '\n';
 
-            for (const issue of issues) {
+            // Deduplicate by GitHub username, keeping only the earliest registration
+            const seen = new Set();
+            const sortedIssues = issues.sort((a, b) => new Date(a.created_at) - new Date(b.created_at));
+
+            for (const issue of sortedIssues) {
+              const username = issue.user.login;
+              if (seen.has(username)) continue;
+              seen.add(username);
+
               const row = [
                 issue.created_at.split('T')[0],
-                issue.user.login,
+                username,
                 parseField(issue.body, 'First Name'),
                 parseField(issue.body, 'Last Name'),
                 parseField(issue.body, 'Email Address'),
@@ -137,7 +266,7 @@ jobs:
             // Write CSV file
             fs.mkdirSync('.github/data', { recursive: true });
             fs.writeFileSync('.github/data/registrations.csv', csv, 'utf-8');
-            console.log(`Exported ${issues.length} registration(s) to .github/data/registrations.csv`);
+            console.log(`Exported ${seen.size} unique registration(s) from ${issues.length} total issue(s) to .github/data/registrations.csv`);
 
       - name: Commit and push CSV
         run: |

html/REGISTER.html

@@ -31,7 +31,14 @@
   <main id="main-content" class="markdown-body">
     <h1>Register for GIT Going with GitHub</h1>
 <p><a href="https://bits-acb.github.io/git-going-with-github/">Back to Home</a> | <a href="https://github.com/BITS-ACB/git-going-with-github/discussions">Discussion Forum</a> | <a href="https://bits-acb.github.io/git-going-with-github/COMING_SOON.html">Pre-Workshop Setup Guide</a></p>
-<p>Registration requires two steps. Both are required to complete your registration.</p>
+<div id="registration-open-intro">
+<p>Registration requires two steps. Both steps are required.</p>
+</div>
+<div id="registration-full-banner" style="display: none;">
+<blockquote>
+<p><strong>Registration is currently full.</strong> All 75 spots have been filled. You can still join the waitlist by filing a GitHub issue below. If a spot opens up, we will contact you.</p>
+</blockquote>
+</div>
 <table>
 <thead>
 <tr>
@@ -65,6 +72,7 @@ <h1>Register for GIT Going with GitHub</h1>
 <blockquote>
 <p><strong>Already registered?</strong> Complete the <a href="https://bits-acb.github.io/git-going-with-github/COMING_SOON.html"><strong>Pre-Workshop Setup Guide</strong></a> before March 7. It walks you through GitHub account setup, screen reader configuration, <a href="https://code.visualstudio.com/">VS Code</a>, and <a href="https://github.com/features/copilot">GitHub Copilot</a> - with instructions for NVDA, JAWS, and VoiceOver.</p>
 </blockquote>
+<div id="section-zoom">
 <hr>
 <h2>Step 1 - Register for the Zoom Session</h2>
 <p>Register for the Zoom session so you receive the meeting link before the workshop.</p>
@@ -76,9 +84,13 @@ <h2>Step 1 - Register for the Zoom Session</h2>
 <ul>
 <li>The <a href="https://zoom.us/">Zoom</a> client works well with <a href="https://www.nvaccess.org/download/">NVDA</a>, <a href="https://www.freedomscientific.com/products/software/jaws/">JAWS</a>, and <a href="https://support.apple.com/guide/voiceover/welcome/mac">VoiceOver</a></li>
 </ul>
+</div>
 <hr>
-<h2>Step 2 - Sign Up on GitHub</h2>
-<p>File a GitHub issue to register. This is intentional - filing an issue is one of the first skills you will learn in this workshop, so you are already practicing.</p>
+<h2 id="github-step-heading">Step 2 - Sign Up on GitHub</h2>
+<div id="section-waitlist-heading" style="display: none;">
+<h2>Join the Waitlist</h2>
+</div>
+<p id="github-step-description">File a GitHub issue to register. This is intentional - filing an issue is one of the first skills you will learn in this workshop, so you are already practicing.</p>
 <p>You must be signed into a <a href="https://github.com">GitHub</a> account to file the issue. If you do not have one yet, create one first using the steps below - then come back to file your registration issue.</p>
 <h3>Need a GitHub Account?</h3>
 <p>If you do not have a GitHub account yet, follow these steps:</p>
@@ -95,10 +107,10 @@ <h3>Need a GitHub Account?</h3>
 </ol>
 <p>After creating your account, check your email for a message from GitHub with the subject &quot;Please verify your email address&quot; and activate the link inside it.</p>
 <p><strong>Enable two-factor authentication</strong> (strongly recommended): Go to <a href="https://github.com/settings/security">github.com/settings/security</a>, find &quot;Two-factor authentication,&quot; and activate &quot;Enable.&quot; An authenticator app (Microsoft Authenticator, Google Authenticator, or Authy) is the most reliable option.</p>
-<h3>File Your Registration Issue</h3>
+<h3 id="file-issue-heading">File Your Registration Issue</h3>
 <p><strong>Important:</strong> You must be signed into your GitHub account before clicking the link below. If you are not signed in, go to <a href="https://github.com">github.com</a> and sign in first.</p>
 <blockquote>
-<p><a href="https://github.com/BITS-ACB/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+GIT+Going+with+GitHub+-+March+2026"><strong>Start Step 2 - File your registration issue</strong></a></p>
+<p><a id="file-issue-link" href="https://github.com/BITS-ACB/git-going-with-github/issues/new?template=workshop-registration.yml&title=%5BREGISTER%5D+GIT+Going+with+GitHub+-+March+2026"><strong>Start Step 2 - File your registration issue</strong></a></p>
 </blockquote>
 <p><strong>Note:</strong> The issue title is pre-filled and required by GitHub. You do not need to change it - just fill out the form fields below it and submit.</p>
 <p>The form asks for:</p>
@@ -112,6 +124,7 @@ <h3>File Your Registration Issue</h3>
 </ul>
 <p>After you submit, you will receive an automated confirmation comment on your issue. Your GitHub username is captured automatically - you do not need to enter it.</p>
 <hr>
+<div id="section-what-happens-open">
 <h2>What Happens Next</h2>
 <p>Once you have completed both steps:</p>
 <ol>
@@ -120,6 +133,16 @@ <h2>What Happens Next</h2>
 <li>Complete the <a href="https://bits-acb.github.io/git-going-with-github/COMING_SOON.html">Pre-Workshop Setup Guide</a> before March 7 - it covers GitHub account setup, screen reader configuration, <a href="https://code.visualstudio.com/">VS Code</a>, and <a href="https://github.com/features/copilot">GitHub Copilot</a></li>
 <li>Questions? Email <a href="mailto:support@bits-acb.org">support@bits-acb.org</a></li>
 </ol>
+</div>
+<div id="section-what-happens-waitlist" style="display: none;">
+<h2>What Happens Next</h2>
+<p>After filing your waitlist issue:</p>
+<ol>
+<li>You will see a confirmation comment on your GitHub issue letting you know you are on the waitlist</li>
+<li>If a spot opens up, we will let you know through your GitHub issue</li>
+<li>Questions? Email <a href="mailto:support@bits-acb.org">support@bits-acb.org</a></li>
+</ol>
+</div>
 <hr>
 <h2>While You Wait</h2>
 <ul>
@@ -136,6 +159,7 @@ <h2>While You Wait</h2>
   </footer>
   <script>
 (function() {
+  var MAX_CAPACITY = 75;
   var url = 'https://api.github.com/search/issues?q=repo:BITS-ACB/git-going-with-github+label:registration+is:issue+is:open';
   var xhr = new XMLHttpRequest();
   xhr.open('GET', url);
@@ -148,6 +172,28 @@ <h2>While You Wait</h2>
         for (var i = 0; i < els.length; i++) {
           els[i].textContent = count;
         }
+
+        if (count >= MAX_CAPACITY) {
+          // Hide registration-open content
+          var hideIds = ['registration-open-intro', 'section-zoom', 'github-step-heading', 'section-what-happens-open'];
+          for (var h = 0; h < hideIds.length; h++) {
+            var el = document.getElementById(hideIds[h]);
+            if (el) el.style.display = 'none';
+          }
+          // Show waitlist content
+          var showIds = ['registration-full-banner', 'section-waitlist-heading', 'section-what-happens-waitlist'];
+          for (var s = 0; s < showIds.length; s++) {
+            var el = document.getElementById(showIds[s]);
+            if (el) el.style.display = '';
+          }
+          // Update text for waitlist context
+          var desc = document.getElementById('github-step-description');
+          if (desc) desc.textContent = 'File a GitHub issue to join the waitlist. Filing an issue is one of the first skills you will learn in this workshop, so you are already practicing.';
+          var heading = document.getElementById('file-issue-heading');
+          if (heading) heading.textContent = 'File Your Waitlist Issue';
+          var link = document.getElementById('file-issue-link');
+          if (link) link.innerHTML = '<strong>File your waitlist issue</strong>';
+        }
       } catch (e) {}
     }
   };