[curriculum-eval] side-quest-01-02-environment-reference.md: cognitive_load — 1433-word glossary plus screenshots, low activity density

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

Línea de trabajo

Empieza con workshop/side-quest-01-02-environment-reference.md y revisa su glosario y la sección «Conceptual screenshots» en relación con los objetivos de extensión y densidad de actividades de la issue. Conserva las secciones con nombre sobre los checkpoints y lo que hay que hacer antes de empezar, y añade comandos prácticos breves con la salida esperada. Si añades un archivo de side quest, actualiza workshop/README.md; la issue también pide ejecutar markdownlint en todos los archivos Markdown.

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

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 (1433 words, 17 concepts) ≤ 800 words, ≤ 15 concepts -3.7
active_learning 2.1 (density 0.63) density ≥ 3 -7.9

(checkpoint_quality/scaffolding flags are scorer false positives; see the rubric-bug issue.)

Root Cause (≤ 2 sentences):
A single page packs a large glossary table and a "Conceptual screenshots" section totalling ~1.8× the word target, with only 2 code blocks. Reference content is delivered as one block rather than looked up on demand.

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 extraneous load rises when learners must hold many unrelated terms in working memory at once; Mayer's segmenting and signaling principles recommend splitting dense material into learner-paced chunks. A reference page that is also a lesson blurs both purposes.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md: reduce it to ≤ 800 words by splitting the "Conceptual screenshots" section into a separate side quest (or trimming to the 3 most important environments), keep the glossary table concise, and add 2–3 short hands-on commands with expected output (e.g. gh --version, git --version) to raise activity density. Keep the `## :white_check_mark: Checkpoint` and `## :clipboard: Before You Start` sections, 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)

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

  • expires on Nov 10, 2026, 4: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.