Skip to content

Reduce cognitive load in Step 16 data-source workshop content - #1377

Merged
pelikhan merged 10 commits into
mainfrom
copilot/curriculum-eval-16-connect-data-source
Jul 17, 2026
Merged

Reduce cognitive load in Step 16 data-source workshop content#1377
pelikhan merged 10 commits into
mainfrom
copilot/curriculum-eval-16-connect-data-source

Conversation

Copilot AI commented Jul 17, 2026

Copy link
Copy Markdown
Contributor

Step 16 introduced too many new concepts at once by explaining output plumbing, expression syntax, heredoc mechanics, and data-fetch commands inline. This update trims that overload while keeping the hands-on workflow edits intact and making the explanation easier to scan.

  • Tighten the conceptual intro

    • Reworked the “Understand the data-flow pattern” section into short causal prose: fetch data first, then pass saved results into the prompt.
    • Removed the inline mini-taxonomy of shell/output/expression concepts that was driving concept count up.
  • Offload secondary mechanics to existing side quests

    • Replaced inline explanations of $GITHUB_OUTPUT, here-document syntax, and scripted-vs-agentic decisions with a compact TIP that links to the existing side quests.
    • Kept the main step focused on the learner’s immediate task instead of teaching multiple subtopics in parallel.
  • Preserve the active-learning path

    • Kept all five code blocks and the same workflow-editing flow.
    • Retained the prediction/try-it prompts, but simplified surrounding prose and checkpoint wording so the learner stays anchored on the data-flow pattern.
  • Keep technical identifiers precise where they matter

    • Preserved exact workflow field names and step IDs where learners need to copy or recognize them (steps:, id: recent, id: issues, commit_log, permissions:, network.allowed-domains).

Example of the updated pattern framing:

[gh-aw workflows](https://github.github.com/gh-aw/introduction/overview/) run inside GitHub Actions, so your workflow can fetch live repository data before the AI writes anything. In this step, you will use shell steps to collect data and a later prompt section to turn that data into a summary.

Think of it as a handoff. First, the workflow gathers facts in a predictable way. Then, the prompt reads those saved results and asks the AI to explain what matters.

Copilot AI and others added 9 commits July 17, 2026 02:48
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Copilot AI changed the title [WIP] Update cognitive load in connect data source documentation Reduce cognitive load in Step 16 data-source workshop content Jul 17, 2026
Copilot AI requested a review from pelikhan July 17, 2026 02:55
@pelikhan
pelikhan marked this pull request as ready for review July 17, 2026 03:02
@pelikhan
pelikhan merged commit bab9516 into main Jul 17, 2026
@pelikhan
pelikhan deleted the copilot/curriculum-eval-16-connect-data-source branch July 17, 2026 03:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[curriculum-eval] 16-connect-data-source.md: cognitive_load — 27 new concepts crammed into 836 words

2 participants