feat: adopt GitHub visual language system in image generation guidelines - #2370
Conversation
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
|
@copilot Apply visual language to existing .svg images - consider writing a script to enforce it or detect violations. |
|
@copilot update guidlines.md to follow https://brand.github.com/ guidance. |
Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
…sfy CodeQL Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com>
Done in commit
Run locally: node scripts/check-svg-visual-language.js
# or for specific files:
SVG_FILES="workshop/images/foo-light.svg workshop/images/foo-dark.svg" node scripts/check-svg-visual-language.js
The checker found 79 existing violations across 37 files (all icon-character issues in older SVGs). These are tracked — the |
Diagrams generated by the workshop image workflows lacked a shared visual vocabulary for GitHub concepts — no consistent icon shapes, no semantic state colors. This adds an authoritative spec and wires it into both image-generation workflows.
guidelines.md— new section: GitHub visual language systemOcticon-inspired shape table for inline SVG primitives: issues (open circle-with-dot / closed solid circle), PRs (branch-merge path), discussions (speech bubble), commits (dot on branch line), workflow runs (play triangle), schedule triggers (clock face)
Primer semantic state color table — hex values for both themes:
#1a7f37#3fb950#cf222e#f85149#8250df#a371f7#57606a#8b949e#9a6700#e3b341Usage rules: GitHub icons required for entity nodes; state must match color; accent blue reserved for non-entity flows; no mixing icon vocabularies
workshop-explanatory-diagrams.mdworkshop-ui-screenshots.md-status indicators with Octicon-inspired shapes and Primer state colors