Skip to content

docs: clarify runner ownership in the README intro - #493

Merged
joshua-temple merged 1 commit into
mainfrom
docs/readme-runner-clarify
Jul 6, 2026
Merged

joshua-temple merged 1 commit into
mainfrom
docs/readme-runner-clarify

Conversation

@joshua-temple

Copy link
Copy Markdown
Collaborator

Problem

The README intro states the generated workflows run on GitHub's own runners as a flat blanket. That reads as if the whole pipeline is locked to GitHub-hosted runners. It is not: cascade's own orchestration jobs run on ubuntu-latest, but your build and deploy callbacks are your own workflow_call workflows, and GitHub Actions determines their runner inside the callback (GitHub Actions forbids runs-on on a job that calls a reusable workflow). So a consumer already controls hosted vs self-hosted for the actual work.

Fix

Reword the intro to say everything runs as native GitHub Actions with no external control plane, and add that build and deploy callbacks run on whatever runners you configure, GitHub-hosted or self-hosted. The manifest reference already documents runs_on as validated-only.

Verification

Single-line prose change. README keeps its two schema-valid manifest examples; the docs build and the README-examples schema test are unaffected.

…-hosted

Signed-off-by: Joshua Temple <joshua.temple@stablekernel.com>
@joshua-temple
joshua-temple merged commit d27d702 into main Jul 6, 2026
15 checks passed
@joshua-temple
joshua-temple deleted the docs/readme-runner-clarify branch July 6, 2026 17:58
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