Skip to content

chore(CI): move the node workflows to 22 - #2212

Merged
DerManoMann merged 1 commit into
zircote:masterfrom
DerManoMann:chore/node-22
Sep 21, 2026
Merged

DerManoMann merged 1 commit into
zircote:masterfrom
DerManoMann:chore/node-22

Conversation

@DerManoMann

Copy link
Copy Markdown
Collaborator

Overview

Node 20 reached end of life in April. The workflows still pass today only because
node-version: '20' resolves to 20.20.2, and @redocly/cli accepts
>=22.12.0 || >=20.19.0 <21.0.0 — 20.20.2 clears that second arm by a single minor.

That arm is the part worth removing. Whenever a future @redocly/cli drops it, the break
arrives as a red spec-validation on whatever dependabot bump happens to be open, pointing
at the bump rather than at the runtime — the same misdirection #2210 fixed for the docs
build, where a dead link surfaced against a manual dispatch instead of the commit that
introduced it.

Changes

All three workflows that run node move together — spec-validation and docs are checks,
gh-pages is the deploy they exist to agree with. Leaving the deploy behind would reopen the
check/deploy split #2210 closed.

  • .github/workflows/spec-validation.yml — node-version: '20' → '22'
  • .github/workflows/docs.yml — same
  • .github/workflows/gh-pages.yml — same

Verification

Run locally against Node 22.23.2, which is what node-version: '22' resolves to today:

result
composer redocly valid — 79 warnings, 181 problems explicitly ignored
composer docs:build green, vitepress 1.6.4
working tree after docs:gen clean

The redocly output is identical line for line to the same lint on Node 20, so no rule
changes behaviour across the bump. vitepress@1.6.4 declares no engines constraint at all.

Node 20 reached end of life in April. It still works today only because
`node-version: '20'` resolves to 20.20.2 and @redocly/cli allows
`>=20.19.0 <21.0.0` — a narrow arm that the next redocly is free to drop, at
which point a routine dependabot bump goes red for a reason that is not about
the bump.

All three workflows that run node move together: `spec-validation` and `docs`
are checks, and `gh-pages` is the deploy they are supposed to agree with.
Verified locally on 22.23.2 — redocly lints identically (79 warnings, 181
ignored) and `docs:build` is green.
@DerManoMann
DerManoMann merged commit 66a3b92 into zircote:master Sep 21, 2026
19 checks passed
@DerManoMann
DerManoMann deleted the chore/node-22 branch September 22, 2026 01:25
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