[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1536-word glossary, lowest activity density

Ouverte Adaptée aux débutants
#5,891 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é
2/5
Temps estimé
1-3 heures
Accessibilité débutants
78/100
Type d'issue
Documentation
Clarté
Clairement spécifiée
Activité
Active
Stack technique
markdown
Domaine
documentation

Piste de recherche

Commence par workshop/side-quest-01-02-environment-reference.md et vérifie les liens entrants vers des ancres telles que #claude depuis side-quest-11-06. Garde le tableau du glossaire comme source de référence, conserve les sections « Before You Start » et « Checkpoint » avec au moins quatre éléments vérifiables, et préserve le bloc bash « Verify-your-tools » tout en réduisant les répétitions. La page est terminée lorsqu’elle compte au plus 900 mots et que npx --yes markdownlint-cli2 "**/*.md" réussit.

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

Description

curriculum documentation quality

File: workshop/side-quest-01-02-environment-reference.md
Overall Score: 4.79 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 5.3 ≤ 800 words, ≤ 15 concepts (actual 1536 words, 19 concepts) −4.7
active_learning 2.4 density ≥ 3 (actual 0.72) −7.6
checkpoint_quality 0.0 (false positive: checkpoint exists; see rubric issue) ≥ 4 items n/a

Root Cause (≤ 2 sentences):
The page is the longest in the corpus (about 2× the 707-word median) because it holds a glossary table, a "Conceptual screenshots" section and seven per-tool subsections that largely repeat the table. Only 4 code blocks exist for 1536 words.

Evidence (quoted from the file):

This is a reference page — you can read it any time. Come back here whenever the workshop uses a term you want to clarify.

Learning Science Rationale:
Sweller's Cognitive Load Theory and Mayer's redundancy principle predict that presenting the same information twice (table plus per-tool prose) adds extraneous load without improving learning. Reference material should be scannable and chunked, with verification tasks kept short.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce it to ≤ 900 words: keep the glossary table as the single source of truth, merge or remove per-tool subsections (GitHub CLI, gh-aw, Copilot CLI, Copilot app, Claude, OpenAI Codex) that repeat it, and keep only unique facts. Retain the ":clipboard: Before You Start" section and the ":white_check_mark: Checkpoint" with ≥ 4 specific verifiable items. Keep the Verify-your-tools bash block. Preserve inbound anchors such as #claude (linked from side-quest-11-06) by keeping headings or updating links. No numbered headings; run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.5 / 10.0 (≈ 8.0 once the checkpoint regex is fixed)

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · ~48 AIC · ⌖ ~1 AIC · ⊞ 5K · ◷

  • expires on Nov 20, 2026, 8:04 AM UTC
Langage dominant
JavaScript
Étoiles
61
Forks
43
Merge moyen
11 h 26 min
PR mergées (30 j)
13

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.