Skip to content

docs: add cross-repo external artifact tracking diagram - #131

Merged
joshua-temple merged 1 commit into
mainfrom
docs/external-artifact-diagram
Jun 13, 2026
Merged

joshua-temple merged 1 commit into
mainfrom
docs/external-artifact-diagram

Conversation

@joshua-temple

Copy link
Copy Markdown
Collaborator

Add a new 'Cross-repo artifact tracking' section to the README with a Mermaid flowchart showing cascade's external artifact model, plus a complementary data-flow diagram in the architecture doc.

The diagram conveys both cross-repo mechanisms:

  • Async external update: artifact repos dispatch the primary's external-update workflow, which serializes writes into the shared manifest and cascades promotions through environments
  • Sync callback: primary workflows invoke artifact-repo workflows inline via uses:

Themed consistently with the existing How it works diagram (teal #36D0C4 lineColor, copper #B87333 accent). Validated on light and dark backgrounds. Docs site build passes.

Signed-off-by: Joshua Temple <joshua.temple@stablekernel.com>
@joshua-temple
joshua-temple merged commit 3e1cd3c into main Jun 13, 2026
8 checks passed
@joshua-temple joshua-temple added the docs Improvements or additions to documentation label Jun 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant