Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

[curriculum-eval] 05-agentic-workflows-intro.md: active_learning — 1,107 words, 0.72 activity density in the core path

Open Beginner friendly
#4,746 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
72/100
Issue type
Refactor
Clarity
Clearly specified
Activity status
Active
Tech stack
github, markdown
Domain
documentation

Research direction

Read workshop/05-agentic-workflows-intro.md, focusing on Activity 2 and the checkpoint; consult side-quest-05-03-two-file-structure.md for the detail to move. Convert the scenarios into a checklist or code task, add the minimal workflow example, trim the prose, and keep at least four checkpoint items. Run the specified markdownlint command; done means the page is at most 850 words with activity density at least 2.

Written by the indexing model from the issue text.

Description

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
active_learning 2.4 density ≥ 3 −7.6 (0.72)
cognitive_load 8.5 ≤ 800 words −1.5 (1,107 words)

Root Cause (≤ 2 sentences):
Despite three 'Activity' headings, most activities are prose-only so only 6 checklist items and a few code blocks exist across ~1,100 words. The page is the pivotal concept step, so the density gap is costly.

Evidence (quoted from the file):

Activity 2 — agentic or standard? (workshop/05-agentic-workflows-intro.md, line 62) — scenarios presented as prose

Learning Science Rationale:
Retrieval-practice and the testing effect show that learners retain more when concepts are immediately applied; Mayer's coherence principle favours trimming prose that doesn't support an activity.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md. Cut ~250 words of explanatory prose (move extended detail to side-quest-05-03-two-file-structure.md by link), convert Activity 2 scenarios into a short checklist or code-block based task, add a small code block showing a minimal `.md` workflow with the `on:` key to identify, and keep Checkpoint ≥ 4 items. Target ≤ 850 words and activity density ≥ 2. Follow AGENTS.md; run `npx --yes markdownlint-cli2 "**/*.md"`.

Expected Score After Fix: ≈ 6.3 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 32.3 AIC · ⌖ 0.79 AIC · ⊞ 10.5K · ◷

  • expires on Oct 20, 2026, 2:48 AM UTC
Dominant language
JavaScript
Stars
53
Forks
35
Avg merge
1d 6h
Merged PRs (30d)
15

Getting set up

Open in Codespaces

Starts the project's dev container in your browser, under your own GitHub account.

  • No Dockerfile or Docker Compose file
  • No pull request template
  • No contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from githubnext/gh-aw-workshop

All issues in githubnext/gh-aw-workshop

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.