Hacktoberfest 2026: le issue che i maintainer hanno segnato per ottobre, aperte e adatte ai principianti. Sfoglia le issue Hacktoberfest

[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — only one retrieval-practice moment after 1,107 words of prose

Aperta Adatta ai principianti
  • Qualcosa non va?
#4,311 0 commenti 0 reazioni 0 assegnatari Vedi su GitHub

I maintainer di solito rispondono entro 1 giorno

Nessuno ha ancora preso questa issue.

Valutazione

Difficoltà
2/5
Tempo stimato
1-3 ore
Idoneità per principianti
78/100
Tipo di issue
Funzionalità
Chiarezza
Specificata chiaramente
Stato di attività
Attiva
Stack tecnologico
github-actions, javascript, markdown
Ambito
content, documentation

Direzione di ricerca

Leggi workshop/05-agentic-workflows-intro.md, in particolare la sezione che introduce trigger, task brief e safe outputs, poi individua la spiegazione di compile/.lock.yml. Aggiungi prima di quella spiegazione un breve punto di checklist o un esercizio di lettura del codice, mantenendo l’esercizio conclusivo esistente; il lavoro è completato quando la pagina include il checkpoint di apprendimento attivo anticipato, come specificato.

Scritto dal modello di indicizzazione a partire dal testo della issue.

Descrizione

curriculum documentation quality

File: workshop/05-agentic-workflows-intro.md
Overall Score: 5.43 / 10.0 (corpus mean: 6.09)

Flagged Dimensions:

Dimension Score Benchmark Delta
cognitive_load 8.5 ≤800 words, ≤15 concepts → 10 -1.5
active_learning 2.4 density ≥ 3 → 10 -7.6

Root Cause (≤ 2 sentences):
At 1,107 words (38% over the 800-word ideal) with only 2 code blocks, this conceptual introduction to agentic workflows relies heavily on explanatory prose to contrast agentic vs. classic Actions workflows, giving an activity density of 0.72 against the 3.0 target even though its concept count (15) is within the ideal range.

Evidence (quoted from the file):

The checkpoint's own "Still uncertain? Try this before moving on" collapsible exercise is the only interactive-recall moment on the page, appearing after all 1,107 words of narrative explanation.

Learning Science Rationale:
Mayer's active-processing principle (part of the Cognitive Theory of Multimedia Learning) argues that learners retain and transfer concepts better when practice opportunities are distributed throughout a lesson rather than concentrated at the end; placing the only retrieval-practice moment in a single collapsible aside after over a thousand words of exposition leaves most of the page's instructional time with no active engagement checkpoint.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md to distribute active-learning opportunities earlier
in the page rather than only at the end. After the section introducing the three key terms
(trigger, task brief, safe outputs), add one short inline checklist item or code-reading
exercise asking the learner to identify these three elements in a short provided workflow
snippet, before continuing to the compile/`.lock.yml` explanation. Keep the existing "Still
uncertain?" exercise at the end but add this earlier checkpoint so code_blocks + checklist_items
density rises relative to the page's word count without needing to cut explanatory content.

Expected Score After Fix: 6.3-6.7 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 96.9 AIC · ⌖ 19.9 AIC · ⊞ 10.4K · ◷

  • expires on Oct 8, 2026, 11:43 PM UTC
Lingua principale
JavaScript
Stelle
52
Fork
26
Merge medio
11h 32m
PR unite (30g)
22

Preparare l'ambiente

Apri in Codespaces

Avvia il container di sviluppo del progetto nel browser, con il tuo account GitHub.

  • Nessun Dockerfile né file Docker Compose
  • Nessun modello di pull request
  • Nessuna guida per i contributori

Come iniziare

  1. Leggi tutta la issue e poi la guida ai contributi del progetto.
  2. Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
  3. Fai un fork del repository e lavora su un branch.
  4. Apri una pull request che faccia riferimento al numero della issue.

Altre issue di githubnext/gh-aw-workshop

Tutte le issue di githubnext/gh-aw-workshop

Issue simili

Altre issue su JavaScript

Ricevi le nuove issue nella tua casella

Un breve riepilogo di issue GitHub adatte ai principianti.