Skip to content

docs: state that Actions are advisory and deploys are not gated on them - #89

Merged
lacymorrow merged 1 commit into
mainfrom
docs/actions-are-advisory
Sep 19, 2026
Merged

lacymorrow merged 1 commit into
mainfrom
docs/actions-are-advisory

Conversation

@lacymorrow

Copy link
Copy Markdown
Contributor

Actions are not paid for on these repos, so jobs stop running whenever the spending limit is hit. That has repeatedly looked like a blocked release when nothing was actually blocked, including for me while syncing downstreams this week.

What I verified

Claim Evidence
Vercel deploys independently of Actions shipkit-www shipped two production deployments on 2026-09-16 while every one of its Actions jobs was failing on billing
No repo requires status checks Branch protection needs GitHub Pro on a private repo; gh api .../branches/main/protection returns 403, so there is nothing to satisfy
Production builds can never be skipped scripts/vercel-ignore-step.sh exits 1 for VERCEL_ENV=production; only preview builds skip, and only on [skip ci]

So a red X from Actions cannot block a merge or a deploy. Only a person can, by waiting on it.

Why write it down

A billing-blocked job fails in under ten seconds with "The job was not started because recent account payments have failed or your spending limit needs to be increased". It looks identical to a real failure in the PR checks list. The doc records how to tell them apart (gh api repos/<owner>/<repo>/check-runs/<id>/annotations) and states plainly that such a job carries no signal.

What gates a release is local verify plus the Vercel build. Actions being green is a bonus, not a requirement.

Docs only, no code change. Commit carries [skip ci].

Actions are not paid for on these repos, so jobs stop running whenever the
spending limit is hit. That has repeatedly looked like a blocked release
when nothing was actually blocked.

Verified while syncing downstreams:

- Vercel deploys through its own Git integration, independent of Actions.
  shipkit-www shipped two production deployments on 2026-09-16 while every
  one of its Actions jobs was failing on billing.
- No repo requires status checks. Branch protection needs GitHub Pro on a
  private repo, so the API returns 403 and there is nothing to satisfy. A
  red check cannot block a merge; only a person can.
- ignoreCommand never skips production. vercel-ignore-step.sh exits 1 for
  VERCEL_ENV=production, so a live site cannot be left stale.

Also records how to recognise a job that never ran: billing-blocked jobs
fail in under ten seconds and carry the "recent account payments have
failed" annotation. That is not a code failure and carries no signal.

What gates a release is local verify plus the Vercel build. [skip ci]
@vercel

vercel Bot commented Sep 19, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
bones Ready Ready Preview Sep 19, 2026 8:22pm UTC

Request Review

@lacymorrow
lacymorrow merged commit 154a30b into main Sep 19, 2026
4 checks passed
@lacymorrow
lacymorrow deleted the docs/actions-are-advisory branch September 19, 2026 20:27
lacymorrow added a commit that referenced this pull request Sep 19, 2026
The note added in #89 said billing-blocked jobs fail in under about ten
seconds. That is not dependable. A shipkit-www "Lint (biome + eslint +
prettier)" job reported 38s and looked exactly like a real lint failure,
but its annotation was the payments message and the job had never run.

Reading the check-run annotation is the only reliable test, so say that
and drop the duration heuristic. [skip ci]
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