[workshop-sim] Improve: Add prediction checkpoints and chunking to GitHub Actions intro (Step 4)

Ouverte
#5,976 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 1 jour

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
35/100
Type d'issue
Documentation
Clarté
Plutôt claire
Activité
Active
Stack technique
github-actions, markdown
Domaine
documentation

Piste de recherche

Start with 04-github-actions-intro.md in the workshop content and read the existing sections before splitting them into 2-3 chunks. Each chunk needs a short predict-then-reveal activity and a checkpoint checklist covering trigger, job, and step, with a worked example added. Done means the markdown lint passes, no heading numbering is introduced, and all existing content and hands-on practice is kept. The scoring formulas in the issue come from the workshop simulator and are not something a newcomer needs to reproduce.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

feedback simulation workshop
Problem

04-github-actions-intro.md has 16.4% conditional dropout (7,249/44,197), entirely concept-overload, concentrated in beginner and github-basic learners (beginner mean success 0.5%). The page introduces ~28 new concepts and has no ## Checkpoint detected by the rubric.

Proposed change

Split the page into 2–3 chunks, each ending with a short predict-then-reveal activity and a checkpoint checklist (trigger, job, step). Keep all current content; add a worked example the learner reads line by line.

Failure mode

Learning barrier — address via scaffolding and checkpoints, not by removing concepts.

Quantitative guardrail

Current: overall 5.39 (lowest in corpus), cognitive_load 6.8, active_learning 3.9, checkpoint_quality 0.0, scaffolding 5.0 (KPI ≈ 2.8). Adding activities and checkpoints raises active_learning and checkpoint_quality, and chunking helps cognitive_load.

Acceptance criteria
  • Shared curriculum assessment overall_score for this step stays flat or improves
  • Learning KPI index (2.0 × active_learning + 2.0 × checkpoint_quality + 1.5 × scaffolding) / 5.5 stays flat or improves
  • Hands-on practice, checkpoints, and scaffolding are preserved or strengthened
  • Markdown lint passes and no heading numbering is introduced
Suggested owner

workshop maintainer
Related to #5975

Generated by 🔬 Workshop Student Simulator · copilot · auto · ~38 AIC · ⌖ ~1 AIC · ⊞ 15.4K · ◷

  • expires on Nov 22, 2026, 11:03 AM UTC
Langage dominant
JavaScript
Étoiles
61
Forks
43
Merge moyen
10 h 38 min
PR mergées (30 j)
12

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

  • Aucun Dockerfile ni fichier Docker Compose
  • Aucun modèle de pull request
  • Aucun guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de githubnext/gh-aw-workshop

Toutes les issues de githubnext/gh-aw-workshop

Issues similaires

Plus d'issues JavaScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.