[workshop-sim] Improve: Add worked troubleshooting callout to GitHub Actions in 5 Minutes

[github-actions]

Problem statement

workshop/04-github-actions-intro.md is the lowest-scoring page in the entire 30-file curriculum (overall_score 5.39/10) and drives the third-highest dropout in the Monte Carlo simulation: a 14.5% conditional dropout rate among 44,166 at-risk simulated runs (95% MC interval 14.2%–14.9%), with concept-overload as the sole recorded failure category (6,414 of the simulated failures at this step). The page introduces 28 new concepts (trigger, job, runner, step, action, plus the Actions-vs-agentic comparison) in one pass, has zero callouts, and its only feedback mechanism for the hands-on labeling exercise is a "Reveal the labels" answer key — there is no guidance for a learner who mislabels a part and doesn't understand why.

Proposed change

Add one short worked-troubleshooting callout immediately after the "Label a sample workflow" exercise (before "Reveal the labels") that walks through why one commonly-confused pair (e.g., runs-on vs. uses) is labeled the way it is, using a > [!TIP] callout consistent with the workshop's alert-severity conventions. This targets the active_learning dimension (currently the second-weakest at 3.9/10) by giving learners a diagnostic path instead of only a pass/fail reveal, without adding new concepts or removing the exercise.

Failure mode classification

Learning barrier — the failure category (concept-overload) reflects conceptual density and absent troubleshooting support, not environment, tooling, or auth friction.

Quantitative guardrail

• Current overall_score: 5.39/10 (lowest in the corpus)
• Weakest rubric dimensions: active_learning 3.9/10, checkpoint_quality 0.0/10 (instrumentation bug tracked separately, not in scope here)
• Current Learning KPI index for this step: 2.78/10 ((2.0×3.9 + 2.0×0.0 + 1.5×5.0)/5.5)
• Adding a diagnostic callout increases activity_density/troubleshooting support without adding word count that would worsen cognitive_load (currently 6.8/10) or reducing the existing labeling/reveal exercise — the change should raise active_learning and therefore the Learning KPI index while leaving overall_score flat or higher.

Acceptance criteria

• The shared curriculum quantitative assessment overall_score for 04-github-actions-intro.md stays flat or improves after the change
• The step's Learning KPI index ((2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5) stays flat or improves
• The existing labeling exercise and "Reveal the labels" answer key are preserved unchanged; the new callout is additive, not a replacement
• Markdownlint passes (npx --yes markdownlint-cli2 "**/*.md") with no new errors

Suggested owner profile

workshop maintainer
Related to #3132

Generated by 🔬 Workshop Student Simulator · copilot · auto · 219.4 AIC · ⌖ 10.3 AIC · ⊞ 15.2K · ◷

• expires on Sep 10, 2026, 5:51 PM UTC

[github-actions]

This issue is being closed as outdated. A newer issue has been created: #3139

View newer issue

---

This action was performed automatically by the Workshop Student Simulator workflow.