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

[curriculum-eval] 05-agentic-workflows-intro.md: cognitive_load — 1,107 words with three activities

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

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
1/5
Estimated time
1-3 hours
Newbie friendliness
94/100
Issue type
Documentation
Clarity
Clearly specified
Activity status
Active
Tech stack
markdown

Research direction

Start with workshop/05-agentic-workflows-intro.md and review the introduction and key-terms explanation around the three activities. Trim the page to no more than 850 words, move the first activity earlier, and merge the duplicate checkpoint sections. Run markdownlint; the work is done when the length, activity order, headings, and lint checks pass.

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
cognitive_load 8.5 ≥ 8 / ≤800 words -3 over word limit (307 words)
active_learning 2.4 ≥ 7 -4.6

Root Cause (≤ 2 sentences):
At 1,107 words the page exceeds the 800-word target by ~38% and its activity density is 2.4/100 words. Prose around the three key terms and diagram precedes the first activity.

Evidence (quoted from the file):

The diagram below shows how each term plays a role when the workflow runs.

Learning Science Rationale:
Sweller's Cognitive Load Theory predicts that learners can hold only a few new elements in working memory; exceeding the concept and length budget raises extraneous load and reduces schema formation. Splitting content into focused, chunked pieces with practice between them restores germane load.

Improvement Prompt (for an agent):

Edit workshop/05-agentic-workflows-intro.md: trim to ≤ 850 words by tightening the intro and the key-terms explanation, and move the first activity earlier. Note the file appears to contain two '## :white_check_mark: Checkpoint' headings; merge them into one. Run markdownlint.

Expected Score After Fix: 6.3 / 10.0

Generated by 🔬 Curriculum Quality Evaluator · copilot · auto · 29.6 AIC · ⌖ 0.746 AIC · ⊞ 10.4K · ◷

  • expires on Oct 19, 2026, 3:41 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.