Skip to content

[workshop-diagrams] Add theme-aware explanatory diagram for terminal command anatomy - #3199

Closed
github-actions[bot] wants to merge 1 commit into
mainfrom
add-terminal-command-anatomy-diagram-3576b0b9b3100320
Closed

[workshop-diagrams] Add theme-aware explanatory diagram for terminal command anatomy#3199
github-actions[bot] wants to merge 1 commit into
mainfrom
add-terminal-command-anatomy-diagram-3576b0b9b3100320

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Summary

Adds a new theme-aware explanatory diagram to workshop/side-quest-01-01-terminal-basics.md — this file previously had no images.

What changed

  • Concept created (not a migration): "Anatomy of a Terminal Command" — a 4-stage left-to-right diagram showing Prompt → Command → Terminal Runs It (Enter) → Output, with a dashed loop-back annotation showing that cd updates the next prompt.
  • New files:
    • workshop/images/side-quest-01-01-command-anatomy-light.svg
    • workshop/images/side-quest-01-01-command-anatomy-dark.svg
  • Markdown edit: inserted one theme-aware <picture> block right after the paragraph that introduces the prompt/command/output terminology, using the light variant as the <img> fallback with descriptive alt text.

Why this helps learners

This side quest is a first-time terminal primer for complete beginners. The four core terms (prompt, command, Enter, output) and the fact that cd changes what the next prompt shows are currently explained only in prose across three separate practice sections. A single compact diagram lets learners see the full request/response loop at a glance before they start typing commands themselves.

QA performed

  • Ran scripts/check-svg-visual-language.js against both new SVGs — no violations.
  • Served the workshop folder locally and used Playwright to render the <picture> block in both light and dark colorScheme contexts, confirming currentSrc correctly resolves to -light.svg and -dark.svg respectively.
  • Visually inspected both renders — all labels stay inside their boxes/chips at normal size, no clipping or overflow.
  • Followed GitHub-brand palette and diagram conventions (.github/skills/github-brand) and the theme-aware <picture> pattern from .github/workflows/guidelines.md.

Warning

Firewall blocked 6 domains

The following domains were blocked by the firewall during workflow execution:

  • accounts.google.com
  • android.clients.google.com
  • clients2.google.com
  • registry.npmjs.org
  • www.google.com
  • www.gstatic.com

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "accounts.google.com"
    - "android.clients.google.com"
    - "clients2.google.com"
    - "registry.npmjs.org"
    - "www.google.com"
    - "www.gstatic.com"

See Network Configuration for more information.

Generated by 🧠 Workshop Explanatory Diagram Generator · copilot · auto · 128.1 AIC · ⌖ 14.1 AIC · ⊞ 10.8K ·

  • expires on Sep 12, 2026, 2:43 AM UTC

Adds a light/dark SVG pair illustrating the four-stage flow of a
terminal command (prompt, command, Enter, output) and how cd loops
back to update the next prompt. Inserts a minimal theme-aware
<picture> reference in the terminal basics side quest right after the
prose that introduces prompt/command/output terminology.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant