[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1,536 words with low activity density

Abierto Apto para principiantes
#5,999 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
82/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
markdown

Línea de trabajo

Abre workshop/side-quest-01-02-environment-reference.md y léelo de principio a fin, prestando atención a la tabla de glosario, las secciones de checkpoint y el bloque «Conceptual screenshots» en las líneas 83–195. Mueve esa sección de capturas de pantalla a un nuevo side-quest-01-04-environment-screenshots.md, enlázalo desde la página principal, añade un breve bloque «Try it» que ejecute gh --version, git --version y gh auth status, y luego añade el nuevo archivo a workshop/README.md. Hecho significa que la página principal tiene menos de ~800 palabras, los encabezados existentes quedan intactos y sin numerar, y que npx --yes markdownlint-cli2 "**/*.md" pasa.

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.8 / 10.0 (corpus mean: 6.1)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 5.3 ≥ 9 (≤ 800 words, ≤ 15 concepts) −3.7 (1,536 words, 19 concepts)
active_learning 2.4 ≥ 10 (density ≥ 3) −7.6 (density 0.72)

(Note: checkpoint_quality 0.0 and scaffolding 5.0 are scorer false positives; the page has both :white_check_mark: Checkpoint and :clipboard: Before You Start sections. See the scorer-regex issue.)

Root Cause (≤ 2 sentences):
A glossary table plus a long "Conceptual screenshots" section (lines 83–195) roughly doubles the page beyond the 800-word ideal. The reference content has only 4 code blocks, so the learner mostly reads instead of acting.

Evidence (quoted from the file):

Knowing which name maps to which role helps you follow workshop instructions without stopping to wonder what "the terminal" or "Codespaces" means in context.

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that long reference material introduced all at once overwhelms working memory and leaves little capacity for schema formation; the segmenting principle (Mayer) recommends splitting content into learner-paced chunks. Pairing each term with a quick verify command (retrieval practice) turns passive reading into active learning.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Split the page so the main file stays under ~800 words: keep the glossary table and checkpoint, and move the "Conceptual screenshots" section (lines 83–195) into a new side-quest file (e.g. side-quest-01-04-environment-screenshots.md) linked from the main page. Add a short "Try it" code block after the glossary that runs `gh --version`, `git --version`, and `gh auth status`. Keep the existing `## :white_check_mark: Checkpoint` and `## :clipboard: Before You Start` headings, do not number headings, update workshop/README.md if a file is added, and run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: 6.5 / 10.0 (before scorer fix); 8.0+ after the scorer fix

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

  • expires on Nov 23, 2026, 4:03 AM UTC
Lenguaje dominante
JavaScript
Estrellas
61
Forks
43
Merge medio
10 h 38 min
PR fusionados (30 d)
12

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.