Skip to content

Commit 801e5c6

Browse files
accesswatchGitHub Workshop Botclaude
authored
fix(enrollment): guide learners who submit the wrong template out of the trap (#240)
A learner clicked the enrollment link but submitted the Start Here roadmap template (issue #237): the [ENROLL] title from the URL survived, the body had the readiness checklist but no Full Name or Email Address fields, and the needs-info bot told them to 'edit this issue and add the missing information' without saying how. They also got the Gandalf first-issue greeting mid-signup, which read as noise. - registration.yml: the needs-info comment now explains the wrong-template cause, gives a copy-paste markdown block for the missing fields, spells out how to edit an issue body, and links the real enrollment form. - learning-room-pr-bot.yml: the first-issue greeting skips [ENROLL] and [REGISTER] intake issues. - start-here-roadmap.yml (main repo chooser only; learning-room copy unchanged): renamed to 'Course Roadmap Check-In (already enrolled students)' with an explicit not-an-enrollment warning and a link to the enrollment form. Co-authored-by: GitHub Workshop Bot <workshop@example.com> Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
1 parent dfd8c53 commit 801e5c6

3 files changed

Lines changed: 32 additions & 4 deletions

File tree

.github/ISSUE_TEMPLATE/start-here-roadmap.yml

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
1-
name: "Start Here: Student Course Roadmap"
2-
description: First-stop guide for students to follow setup, challenges, and support resources in order.
1+
name: "Course Roadmap Check-In (already enrolled students)"
2+
description: For students who already have a learning room. Enrolling? Use "Workshop Enrollment - New Student Fast Path" instead.
33
title: "Start Here: Student Course Roadmap (@{username})"
44
labels: ["onboarding", "student"]
55
body:
@@ -8,6 +8,10 @@ body:
88
value: |
99
## Start Here: Student Course Roadmap
1010
11+
> **Not enrolled yet?** This form does not enroll you. Use the
12+
> [Workshop Enrollment form](https://github.com/Community-Access/git-going-with-github/issues/new?template=enrollment.yml&title=%5BENROLL%5D+GIT+Going+with+GitHub)
13+
> instead - it asks for your name and email and creates your private learning room.
14+
1115
Use this issue as your launch point for the full workshop path.
1216
1317
### Step 1: Open the Roadmap

.github/workflows/learning-room-pr-bot.yml

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -23,7 +23,13 @@ jobs:
2323
welcome-issue-timer:
2424
name: Welcome to Your First Issue
2525
runs-on: ubuntu-latest
26-
if: github.event_name == 'issues' && github.event.action == 'opened'
26+
# Skip intake issues (enrollment/registration): those get their own
27+
# automation comments, and a "first issue" greeting there confuses
28+
# brand-new learners mid-signup.
29+
if: >-
30+
github.event_name == 'issues' && github.event.action == 'opened' &&
31+
!startsWith(github.event.issue.title, '[ENROLL]') &&
32+
!startsWith(github.event.issue.title, '[REGISTER]')
2733
steps:
2834
- name: Greet First Issue
2935
uses: actions/github-script@v8

.github/workflows/registration.yml

Lines changed: 19 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -247,7 +247,25 @@ jobs:
247247
'',
248248
`Hi ${displayName}, we could not process enrollment because some required values were missing: ${process.env.MISSING_FIELDS}.`,
249249
'',
250-
'Please edit this issue and add the missing information, then comment `ready` so a facilitator can retry.'
250+
'This usually happens when the issue was created from a different template than the enrollment form, so the name and email questions never appeared.',
251+
'',
252+
'**Easiest fix:** edit this issue and paste the lines below at the top of the issue body, filling in your details:',
253+
'',
254+
'```markdown',
255+
'### Full Name',
256+
'',
257+
'Your Name Here',
258+
'',
259+
'### Email Address',
260+
'',
261+
'you@example.com',
262+
'```',
263+
'',
264+
'To edit: open this issue, find the **Edit** option on the first post (in the `...` menu at the top right of the post), make the change, and select **Update comment**.',
265+
'',
266+
'When you are done, comment `ready` so a facilitator can retry.',
267+
'',
268+
'Prefer to start over instead? Use the enrollment form directly: https://github.com/Community-Access/git-going-with-github/issues/new?template=enrollment.yml&title=%5BENROLL%5D+GIT+Going+with+GitHub'
251269
];
252270
253271
await github.rest.issues.createComment({

0 commit comments

Comments
 (0)