feat: add student course roadmap and Start Here onboarding template by accesswatch · Pull Request #188 · Community-Access/git-going-with-github

accesswatch · 2026-05-05T04:58:41Z

Summary

Adds a student-facing course roadmap and onboarding issue template to guide students step-by-step through the full workshop.

Changes

\learning-room/docs/course-roadmap.md\ - full step-by-step student guide (Day 1, Day 2, Bonus, support path, completion checklist)
\learning-room/.github/ISSUE_TEMPLATE/start-here-roadmap.yml\ - onboarding issue template with canonical absolute URLs to roadmap, challenge hub, solutions, and student guide
\learning-room/README.md\ - fixed broken relative paths to challenge hub and workshop docs, added roadmap link
\learning-room/.github/STUDENT_GUIDE.md\ - corrected challenge hub path, added roadmap link
.github/scripts/tests/challenge-doc-consistency.test.js\ - added 3 new drift gates enforcing roadmap existence, entry-point links, and template resource URLs

Validation

Automation: 68/68 pass
Classroom self-test: 9/9 pass

… nav fixes Added: - learning-room/docs/course-roadmap.md - full step-by-step student guide (Day 1, Day 2, Bonus, support order, completion checklist) - learning-room/.github/ISSUE_TEMPLATE/start-here-roadmap.yml - onboarding issue template linking roadmap, challenge hub, solutions, student guide via canonical absolute URLs Fixed: - learning-room/README.md: broken relative paths to challenge hub and workshop docs - learning-room/.github/STUDENT_GUIDE.md: corrected challenge hub path, added roadmap link Tests: - Added course-roadmap existence and content gate - Added entry-point link enforcement for README and Student Guide - Added Start Here template existence and canonical URL gate - All 68 automation tests pass, classroom self-test 9/9 pass

github-actions · 2026-05-05T04:58:54Z

Learning Room Validation Report

Great work. Your changes look good.

Resources

github-actions · 2026-05-05T04:58:57Z

github-actions · 2026-05-05T04:59:06Z

Hi! I am Aria. Here is my review of your pull request:

Report Status

Validation Needs Attention [ACTION REQUIRED]

Required Checks

Issue Reference
PR should reference the issue it addresses (e.g., "Closes [REGISTER] GIT Going with GitHub - March 2026 #12")
Add "Closes #XX" to your PR description to automatically close the issue when merged. Learn more: docs/04-working-with-issues.md
PR Description
File Location
Changes should be in learning-room/ directory only
Student contributions should modify files in learning-room/docs/ only. Other directories are workshop infrastructure.

Suggestions for Improvement

These are optional but will make your contribution even better:

Good use of code blocks for examples
Code blocks help both sighted and non-sighted users understand technical content.
Tables include proper headers
Screen readers announce table headers, helping users navigate data.
Tables include proper headers
Screen readers announce table headers, helping users navigate data.

Accessibility Analysis

Non-Descriptive Link Text
Found 1 instance(s) of "click here" link text. Screen reader users can't tell where the link goes.
learning-room/.github/STUDENT_GUIDE.md
Fix: Replace with descriptive text like "View keyboard shortcuts guide" or "Download the setup instructions".
Non-Descriptive Link Text
Found 2 instance(s) of "link" link text. Screen reader users can't tell where the link goes.
learning-room/.github/STUDENT_GUIDE.md
Fix: Replace with descriptive text like "View keyboard shortcuts guide" or "Download the setup instructions".
Missing Image Alt Text
Images must have descriptive alt text for screen reader users.
learning-room/.github/STUDENT_GUIDE.md
Fix: Add descriptive alt text:
Broken Link
Link points to non-existent file: image.jpg
learning-room/.github/STUDENT_GUIDE.md
Fix: Verify the file path is correct or check if the file exists.
Broken Link
Link points to non-existent file: ../docs/guide.md
learning-room/.github/STUDENT_GUIDE.md
Fix: Verify the file path is correct or check if the file exists.
Broken Link
Link points to non-existent file: ../docs/guide.md
learning-room/.github/STUDENT_GUIDE.md
Fix: Verify the file path is correct or check if the file exists.
Broken Link
Link points to non-existent file: ../docs/markdnown-guide.md
learning-room/.github/STUDENT_GUIDE.md
Fix: Verify the file path is correct or check if the file exists.
Broken Link
Link points to non-existent file: ../docs/markdown-guide.md
learning-room/.github/STUDENT_GUIDE.md
Fix: Verify the file path is correct or check if the file exists.

Learning Resources

Based on your changes, these guides might help:

Automated validation by Learning Room Bot. Aria generated this review. Last updated: 2026-05-05T04:59:05.998Z
Questions? Check PR Guidelines or mention @Facilitator

github-actions · 2026-05-05T05:00:59Z

Progress Update

Great work, @accesswatch!

Current Level: Explorer
Merged PRs: 6
Next Level: Contributor (NaN more merged PRs)

Available Challenges:

01 Scavenger Hunt
02 First Issue
03 Join Conversation

Keep going!

Copilot

Pull request overview

Adds a student-facing course roadmap and an optional onboarding issue form to the Learning Room template, while updating documentation entry points and adding consistency checks around the new resources.

Changes:

Added learning-room/docs/course-roadmap.md as a step-by-step Day 1/Day 2/bonus path for students.
Added a new start-here-roadmap.yml issue form and linked the roadmap from the Learning Room README and student guide.
Extended challenge-doc-consistency.test.js with new checks for roadmap presence and resource links.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
`learning-room/README.md`	Updates student-facing entry links and adds a roadmap shortcut.
`learning-room/docs/course-roadmap.md`	Introduces the new roadmap document for workshop progression.
`learning-room/.github/STUDENT_GUIDE.md`	Adds roadmap reference and updates challenge hub link.
`learning-room/.github/ISSUE_TEMPLATE/start-here-roadmap.yml`	Adds a new onboarding issue form with resource links.
`.github/scripts/__tests__/challenge-doc-consistency.test.js`	Adds drift checks for roadmap existence and link targets.

+name: "Start Here: Student Course Roadmap"
+description: First-stop guide for students to follow setup, challenges, and support resources in order.
+title: "Start Here: Student Course Roadmap (@{username})"
+labels: ["onboarding", "student"]


 14. Add a final issue comment with what you learned and your merged PR link

-See the [workshop documentation](../../docs/) for full step-by-step guidance.
+See the [workshop documentation](../docs/) for full step-by-step guidance.


 - **Celebrate milestones** (first challenge, Day 1 complete, all challenges complete)

-[**View Available Challenges →**](docs/CHALLENGES.md)
+[**View Available Challenges →**](../docs/CHALLENGES.md)


+1. Read the [Setup Guide](setup-guide.md).
+2. Open the [Challenge Hub](../../docs/CHALLENGES.md).
+3. Keep the [Keyboard Shortcuts](keyboard-shortcuts.md) page open if useful.


 - [Markdown Reference (Appendix C)](https://github.com/Community-Access/git-going-with-github/blob/main/docs/appendix-c-markdown-reference.md)
 - [Accessibility Standards (Appendix M)](https://github.com/Community-Access/git-going-with-github/blob/main/docs/appendix-m-accessibility-standards.md)
- [Challenge Hub](../docs/CHALLENGES.md)
+- [Challenge Hub](../../docs/CHALLENGES.md)


+  assert.match(
+    readme,
+    /\[\*\*View Available Challenges →\*\*\]\(\.\.\/docs\/CHALLENGES\.md\)/,
+    'learning-room/README.md should link to canonical challenge hub path'
+  );
+
+  assert.match(
+    studentGuide,
+    /\[Course Roadmap\]\(\.\.\/docs\/course-roadmap\.md\)/,
+    'learning-room/.github/STUDENT_GUIDE.md should link to course roadmap'


 ## How to Contribute

-1. Open the canonical challenge list: `docs/CHALLENGES.md`
+1. Open the canonical challenge list: `../docs/CHALLENGES.md`


+- Completed capstone challenge (16)
+- Optional: completed bonus challenges (A-E)
+
+When in doubt, return to the [Challenge Hub](../../docs/CHALLENGES.md). It is the canonical challenge reference.


Copilot AI review requested due to automatic review settings May 5, 2026 04:58

accesswatch requested a review from taylorarndt as a code owner May 5, 2026 04:58

github-actions Bot added documentation Improvements or additions to documentation needs-work accessibility labels May 5, 2026

accesswatch merged commit e815609 into main May 5, 2026
11 of 12 checks passed

accesswatch deleted the feat/student-roadmap-onboarding branch May 5, 2026 05:01

Copilot AI reviewed May 5, 2026

View reviewed changes

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add student course roadmap and Start Here onboarding template#188

feat: add student course roadmap and Start Here onboarding template#188
accesswatch merged 1 commit intomainfrom
feat/student-roadmap-onboarding

accesswatch commented May 5, 2026

Uh oh!

github-actions Bot commented May 5, 2026

Uh oh!

github-actions Bot commented May 5, 2026

Uh oh!

github-actions Bot commented May 5, 2026

Uh oh!

Uh oh!

github-actions Bot commented May 5, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

accesswatch commented May 5, 2026

Summary

Changes

Validation

Uh oh!

github-actions Bot commented May 5, 2026

Learning Room Validation Report

Resources

Uh oh!

github-actions Bot commented May 5, 2026

Peer Review Assigned

For @taylorarndt:

Uh oh!

github-actions Bot commented May 5, 2026

Report Status

Required Checks

Suggestions for Improvement

Accessibility Analysis

Learning Resources

Uh oh!

Uh oh!

github-actions Bot commented May 5, 2026

Progress Update

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants