Skip to content

Update cross-repo workflow diagrams#464

Merged
bschwedler merged 1 commit into
mainfrom
update-workflow-diagrams
Apr 16, 2026
Merged

Update cross-repo workflow diagrams#464
bschwedler merged 1 commit into
mainfrom
update-workflow-diagrams

Conversation

@bschwedler
Copy link
Copy Markdown
Contributor

Summary

  • Use short repo names in subgraph labels
  • Full workflow filenames with click links to GitHub
  • Explicit parameter names on all dispatch and workflow_call edges
  • Direct dispatch arrows from product repo to image repo (removes intermediate bot nodes from per-product diagrams)

Test plan

  • Render the Quarto docs and verify all diagrams display correctly
  • Verify click links resolve to the correct workflow files

@bschwedler bschwedler requested a review from ianpittwood as a code owner April 15, 2026 14:39
@github-actions
Copy link
Copy Markdown

github-actions Bot commented Apr 15, 2026

Test Results

1 328 tests   1 328 ✅  8m 32s ⏱️
    1 suites      0 💤
    1 files        0 ❌

Results for commit a54dd56.

♻️ This comment has been updated with latest results.

@bschwedler bschwedler force-pushed the update-workflow-diagrams branch 2 times, most recently from a54dd56 to 637a180 Compare April 16, 2026 15:59
Overhaul the workflow architecture diagrams to represent the
desired future state of the cross-repo dispatch system.

Visual language:
- Thick lines for workflow_dispatch (cross-repo, async)
- Dashed lines for workflow_call (same CI run)
- Thin lines for push, Flux sync, PR merge
- Hexagon nodes for GitHub App identities
- Cylinder nodes for registries
- Stadium nodes for environments
- Workflow parameters as italic text within nodes

Per-product diagrams show the full detail: source workflow,
GitHub App identity, target workflow with parameters, shared
workflow calls, registry push targets, and deployment
environments. Combined overview diagrams stay clean with just
line styles communicating the mechanism.

Add callout noting this document represents the desired future
state. Link to #302 for implementation status.
@bschwedler bschwedler force-pushed the update-workflow-diagrams branch from 637a180 to 5566adb Compare April 16, 2026 15:59
@bschwedler bschwedler merged commit adca03c into main Apr 16, 2026
@bschwedler bschwedler deleted the update-workflow-diagrams branch April 16, 2026 16:00
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.

1 participant