Hacktoberfest 2026: los issues que los mantenedores marcaron para octubre, abiertos y aptos para principiantes. Explorar issues de Hacktoberfest

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

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

Línea de trabajo

Comienza leyendo workshop/side-quest-01-02-environment-reference.md y buscando con grep en workshop/ los enlaces a sus anclas. Edita el archivo para reemplazar la prosa con una tabla term|role|when-you-use-it, mueve las notas de enterprise a bloques <details> y añade una autocomprobación gh --version. Hecho cuando el archivo tiene ≤900 palabras, los anclas se preservan y npx --yes markdownlint-cli2 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.93 / 10.0 (corpus mean: 6.06)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 6.3 ≥ 9 (≤ 800 words) −2.7
active_learning 2.1 ≥ 10 (density ≥ 3) −7.9

(checkpoint_quality 0.0 / scaffolding 5.0 are rubric artifacts — see the separate rubric-regex issue.)

Root Cause (≤ 2 sentences):
At 1433 words (2× the corpus median of 706) and 17 concepts, this reference page has only 2 code blocks and 7 checklist items, so activity density is 0.63. It mixes a glossary, screenshots and enterprise notes in a single linear read.

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 the Segmenting principle (Mayer) suggest long reference material should be chunked so learners look up only what they need. A glossary has legitimately low activity density, but splitting it lowers per-page load and makes anchor-links from lessons land on shorter pages.

Improvement Prompt (for an agent):

Edit workshop/side-quest-01-02-environment-reference.md (a reference page, Bloom level "remember"). Reduce it to ≤ 900 words by (a) replacing prose descriptions with a compact term | role | when-you-use-it table, (b) moving the enterprise-hostname and OpenAI Codex/Claude model notes into short <details> blocks, and (c) keeping every existing heading anchor that other workshop pages link to (grep workshop/ for "side-quest-01-02-environment-reference.md#" first). Add a quick self-check (one code block with `gh --version`, `git --version`) near the top so density rises. Keep the ":white_check_mark: Checkpoint" section. Run `npx --yes markdownlint-cli2 "workshop/side-quest-01-02-environment-reference.md"`.

Expected Score After Fix: 6.0 / 10.0 (≈ 8.0 once the rubric regex fix lands)

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

  • expires on Oct 26, 2026, 3:44 AM UTC
Lenguaje dominante
JavaScript
Estrellas
55
Forks
36
Merge medio
2 d 8 h
PR fusionados (30 d)
17

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.