Skip to content

[workshop-sim] Repair: Add concept-chunking and correction paths to Step 4 (GitHub Actions intro) #2664

Description

@github-actions

Problem statement

04-github-actions-intro.md introduces 25 new concepts (rubric new_concepts: 25) in 642 words, producing a cognitive_load score of 7.5/10 and a concept-overload dropout count of 7,937 — the single largest failure-count category in the corpus. The labeling activity does not provide guidance for learners who label incorrectly; only a reveal path is offered. The "Try it" browser exploration has no troubleshooting note if the learner cannot find a workflow file. troubleshootingSupport is 0.0 for this step.

Proposed change

  1. Group the 25 concepts into three mini-sections: (a) workflow location and triggers, (b) jobs and runners, (c) steps and actions. Introduce each group with one worked, annotated example before the labeling activity.
  2. Add a correction path to the labeling activity: after the reveal, add one paragraph on which labels beginners most often confuse (runner vs step) and why.
  3. Add a one-line troubleshooting note to the "Try it" section: if the learner cannot find a workflow file in the Actions tab, suggest github.com/actions/checkout as a reliable public repo.

Do not remove the labeling activity or the browser exploration — both provide active practice that maintains active_learning above its current 4.6/10.

Failure mode classification

Learning barrier — the issue is conceptual density and the absence of correction guidance, not tooling or auth.

Quantitative guardrail

  • Current overall_score: 7.42 / 10 (weakest dimension: active_learning 4.6/10, scaffolding 5.0/10)
  • Current learning KPI index: 6.67 / 10 (active_learning 4.6 · checkpoint_quality 10.0 · scaffolding 5.0)
  • The proposed change adds scaffolded concept grouping and a correction path, targeting the two weakest dimensions. The overall_score should remain at or above 7.42; the learning KPI index should rise as active_learning and scaffolding improve.

Acceptance criteria

  • The shared curriculum quantitative assessment overall_score for 04-github-actions-intro.md stays at 7.42 or above after the change
  • The step learning KPI index ((2 × active_learning + 2 × checkpoint_quality + 1.5 × scaffolding) / 5.5) stays at 6.67 or above
  • The labeling activity, browser exploration, and concept-reveal <details> elements are preserved or strengthened — none are removed or shortened
  • A correction note for the most commonly confused labels (runner vs step) is present in the labeling activity section

Suggested owner

workshop maintainer
Related to #2663

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🔬 Workshop Student Simulator · 80.9 AIC · ⌖ 8.17 AIC · ⊞ 10.4K ·

  • expires on Aug 17, 2026, 2:54 AM UTC

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions