Skip to content

Add fast-path guidance for experienced users in Steps 4 and 5#52

Merged
pelikhan merged 12 commits into
mainfrom
copilot/workshop-sim-improve-fast-path-skip-callouts
Jul 11, 2026
Merged

Add fast-path guidance for experienced users in Steps 4 and 5#52
pelikhan merged 12 commits into
mainfrom
copilot/workshop-sim-improve-fast-path-skip-callouts

Conversation

Copilot AI commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

Advanced users were dropping in the GitHub Actions intro sequence because Steps 4–5 did not clearly signal a faster path to the hands-on agentic workflow content. This update makes the skip path explicit while preserving the beginner-oriented explanations.

  • Step 4: experienced Actions user fast path

    • Added a visible > [!TIP] callout near the top of 04-github-actions-intro.md
    • Directs users already comfortable with Actions workflows and YAML to skip to Step 6
    • Keeps Step 5 positioned as optional conceptual background
  • Step 5: experienced automation user fast path

    • Added a visible > [!TIP] callout near the top of 05-agentic-workflows-intro.md
    • Directs users familiar with LLM-based automation to review a short summary, complete Step 6, then jump to Step 7
  • Step 5: concise delta from classic Actions

    • Added a Quick Summary box that focuses on the actual transition from classic Actions to gh-aw
    • Highlights:
      • YAML frontmatter remains
      • workflow logic moves from fixed jobs.steps scripts to a Markdown task brief
      • runtime behavior is constrained by declared permissions and safe outputs
> [!TIP]
> Already comfortable with GitHub Actions workflows and YAML? You can skip this step and go straight to [Step 6: Install the gh-aw CLI Extension](06-install-gh-aw.md).

## Quick Summary

> **Key differences from classic Actions:**
> - A `gh-aw` workflow still starts with YAML frontmatter fenced by `---`, usually with `name`, `on`, and `permissions`.
> - Below that frontmatter, you write a Markdown task brief instead of a fixed `jobs.steps` script.
> - The agent uses that brief plus the declared permissions and safe outputs to decide how to complete the work at runtime.

Copilot AI and others added 11 commits July 11, 2026 11:38
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>
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] Add fast-path skip callouts for experienced users in Steps 4 and 5 Add fast-path guidance for experienced users in Steps 4 and 5 Jul 11, 2026
Copilot AI requested a review from pelikhan July 11, 2026 11:45
@pelikhan pelikhan marked this pull request as ready for review July 11, 2026 12:01
@pelikhan pelikhan merged commit 1e75ce8 into main Jul 11, 2026
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.

[workshop-sim] Improve: Add fast-path skip callouts for experienced users in Steps 4 and 5

2 participants