Skip to content

[workshop-diagrams] Add theme-aware explanatory diagram for conditional logic flow - #2683

Draft
github-actions[bot] wants to merge 1 commit into
mainfrom
diagram/15-conditional-flow-brand-migration-cc7a7422c906ae5e
Draft

[workshop-diagrams] Add theme-aware explanatory diagram for conditional logic flow#2683
github-actions[bot] wants to merge 1 commit into
mainfrom
diagram/15-conditional-flow-brand-migration-cc7a7422c906ae5e

Conversation

@github-actions

Copy link
Copy Markdown
Contributor

Summary

This PR migrates the existing 15-conditional-flow SVG pair in workshop/15-conditional-logic.md from ad-hoc GitHub Primer colors to a fully brand-compliant light/dark pair.

Workshop file changed

workshop/15-conditional-logic.md — the <picture> block already existed; the two SVG files it references were rebuilt to match the workshop brand palette and accessibility requirements.

Change type: Migration of existing diagram

The diagram content, geometry, layout, and alt text are preserved. This is a visual quality improvement, not new content.

SVG files updated

  • workshop/images/15-conditional-flow-light.svg
  • workshop/images/15-conditional-flow-dark.svg

Why the diagram helps learners

The conditional logic flow is a foundational concept — it shows how a deterministic shell step gates the AI agent job. The diagram already existed but used off-brand Primer colors, font sizes below the 16px diagram label minimum, no data-visual-kind/data-visual-id/data-node metadata, and Unicode emoji in <text> nodes (which the SVG visual language check flags as violations).

Changes made

Issue Fix
Off-brand colors (GitHub Primer palette) Applied workshop brand palette: #f2f5f3/#101411 backgrounds, #08872b/#5fed83 accents
Label font sizes 11–13px (below 16px minimum) All diagram labels raised to 16px; annotations 14px
Missing data-visual-kind / data-visual-id Added to root <svg>
Missing data-node / data-state Added to all nodes; state nodes use correct Primer semantic colors
Arial / monospace font stack Switched to Mona Sans / Mona Sans Mono with system fallbacks
Unicode emoji in <text> nodes Removed; replaced with plain text labels
1.5px connector strokes Updated to 2px minimum as required

QA

  • SVG_FILES=... node scripts/check-svg-visual-language.js — 0 violations
  • ✅ Playwright light mode: currentSrc ends with -light.svg
  • ✅ Playwright dark mode: currentSrc ends with -dark.svg
  • ✅ Screenshots non-blank (~58KB each)

Warning

Firewall blocked 9 domains

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

  • accounts.google.com
  • android.clients.google.com
  • awmgmcpg
  • clients2.google.com
  • clientservices.googleapis.com
  • host.docker.internal
  • redirector.gvt1.com
  • 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"
    - "awmgmcpg"
    - "clients2.google.com"
    - "clientservices.googleapis.com"
    - "host.docker.internal"
    - "redirector.gvt1.com"
    - "www.google.com"
    - "www.gstatic.com"

See Network Configuration for more information.

Generated by 🧠 Workshop Explanatory Diagram Generator · 213.9 AIC · ⌖ 6.83 AIC · ⊞ 6.8K ·

  • expires on Aug 18, 2026, 5:08 AM UTC

…G pair

- Apply workshop brand palette (#f2f5f3/#101411 backgrounds, #08872b/#5fed83 accents)
- Raise all label font sizes to 16px minimum (was 11-13px)
- Add data-visual-kind, data-visual-id, data-node, data-state attributes
- Use Primer semantic state colors for data-state nodes (done=#1a7f37/#3fb950, skipped=#57606a/#8b949e)
- Replace Arial/monospace with Mona Sans / Mona Sans Mono font stack
- Remove Unicode emoji from text nodes; use text labels only
- Minimum 2px connector strokes with proper arrow markers
- Verified via Playwright: light currentSrc ends -light.svg, dark currentSrc ends -dark.svg

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.

0 participants