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

Abierto Apto para principiantes
#5,891 0 comentarios 0 reacciones 0 asignados Ver en GitHub

Los mantenedores suelen responder en 1 día

Nadie ha tomado este issue todavía.

Evaluación

Dificultad
2/5
Tiempo estimado
1-3 horas
Aptitud para principiantes
78/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
markdown

Línea de trabajo

Empieza con workshop/side-quest-01-02-environment-reference.md y comprueba los enlaces entrantes a anclas como #claude desde side-quest-11-06. Mantén la tabla del glosario como fuente de referencia, conserva las secciones «Before You Start» y «Checkpoint» con al menos cuatro elementos verificables y preserva el bloque bash «Verify-your-tools», reduciendo al mismo tiempo el material repetido. La página estará lista cuando tenga como máximo 900 palabras y npx --yes markdownlint-cli2 "**/*.md" pase.

Escrito por el modelo de indexación a partir del texto del issue.

Descripción

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
Lenguaje dominante
JavaScript
Estrellas
61
Forks
43
Merge medio
11 h 26 min
PR fusionados (30 d)
13

Preparar el entorno

Abrir en Codespaces

Inicia el contenedor de desarrollo del proyecto en tu navegador, con tu propia cuenta de GitHub.

  • Sin Dockerfile ni archivo de Docker Compose
  • Sin plantilla de pull request
  • Sin guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Más de githubnext/gh-aw-workshop

Todos los issues de githubnext/gh-aw-workshop

Issues similares

Más issues de JavaScript

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.