[curriculum-eval] side-quest-01-02-environment-reference.md: active_learning — 1433-word glossary with density 0.63

Abierto Apto para principiantes
  • ¿Algo no está bien?
#5,542 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
79/100
Tipo de issue
Documentación
Claridad
Bien especificado
Estado de actividad
Activo
Stack tecnológico
github, markdown
Área
content, documentation

Línea de trabajo

Lee workshop/side-quest-01-02-environment-reference.md, centrándote en el glosario, “Conceptual screenshots” y las secciones “Checkpoint”. Conserva solo los términos del glosario que se usan en los pasos 01–07 del taller, resume o divide la sección de capturas de pantalla y añade 3–4 comprobaciones breves de comandos con la salida esperada. Conserva las secciones “Checkpoint” y “Before You Start”; ejecuta markdownlint-cli2 y confirma que la página tiene como máximo 900 palabras.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≥ 8 (≤ 800 words) −1.7 (1433 words, 17 concepts)
active_learning 2.1 10 (density ≥ 3) −7.9 (density 0.63)

(missing_checkpoint is a false positive; the page has ## :white_check_mark: Checkpoint at line 155.)

Root Cause (≤ 2 sentences):
The lowest-scoring page is a reference glossary nearly twice the word guideline, with a "Conceptual screenshots" section (lines 54–154) dominating the page. Only 2 code blocks and 7 checklist items support 1433 words.

Evidence (quoted from the file):

When you're ready to verify your tools are working, see the Checkpoint (link unavailable: invalid HTTPS URL) section at the bottom.

Learning Science Rationale:
Mayer's coherence and segmenting principles argue that long reference material should be broken into learner-paced pieces and stripped of non-essential content; Cognitive Load Theory predicts novices cannot retain a 1400-word glossary without applying it. Adding short "try it" commands converts passive reference into retrieval practice.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md. Reduce to ≤ 900 words by tightening the glossary (keep only terms used in workshop steps 01–07) and condensing or splitting the "Conceptual screenshots" section into a collapsed <details> or a separate side quest. After the glossary add 3–4 short "check it yourself" code blocks (e.g. `gh --version`, `git --version`) with expected output. Keep the Checkpoint with ≥ 4 items and the Before You Start section; update workshop/README.md if you add a file; run markdownlint-cli2.

Expected Score After Fix: 6.8 / 10.0

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

  • expires on Nov 11, 2026, 3:04 AM UTC
Lenguaje dominante
JavaScript
Estrellas
58
Forks
40
Merge medio
1 d 22 h
PR fusionados (30 d)
7

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.