Skip to content

docs: write the v22 upgrade guide for the release candidate - #3824

Open
armando-navarro wants to merge 1 commit into
angular:mainfrom
armando-navarro:b36-upgrade-guide-rc0
Open

armando-navarro wants to merge 1 commit into
angular:mainfrom
armando-navarro:b36-upgrade-guide-rc0

Conversation

@armando-navarro

Copy link
Copy Markdown
Collaborator

Checklist

  • Issue number for this PR: Angular 22 release please #3737
  • Docs included?: yes, this is docs only.
  • Test units included?: no, docs only.
  • Breaking change?: no.
  • In a clean directory, yarn install, yarn test run successfully? Not run, no code changes. Markdown only, so the merge publishes no canary.

Description

Prepares docs/version-22-upgrade.md for 22.0.0-rc.0, which publishes under the next tag. Refs #3737.

  • Every @angular/fire@canary becomes @angular/fire@next, and the title names the release candidate instead of the canary.
  • A "Deploy builder" section states the deprecation feat(deploy): deprecate deploying server-side rendering to Cloud Functions #3803 shipped: deploying server-side rendering to Cloud Functions with ng deploy is deprecated in 22 and removed in 23. Hosting-only and Cloud Run deploys are not deprecated.
  • An "Other notes" section covers Node.js 20 (not supported, Angular 22 requires ^22.22.3 || ^24.15.0 || >=26.0.0), TypeScript 6 (strict on by default, downlevelIteration dropped, baseUrl and moduleResolution: "node" deprecated), the v21 migration running once more for apps coming from a 21 release candidate, the ng update @angular/fire@next route for canary installs, and screen tracking's move to reflectComponentType as a change with no effect on apps.

Verification

  • ng update @angular/core@22 @angular/cli@22 @angular/fire@canary on a fresh Angular 21.2.25 app with @angular/fire 21.0.0: exit 0, Angular 22.2.3, TypeScript 6.0.3, both AngularFire migrations ran, ng build passes. The @next command is the same command once the tag publishes.
  • grep canary docs/version-22-upgrade.md finds only the new note for canary installs.

The guide said @angular/fire@canary everywhere, which stops being the
installable 22 build once 22.0.0-rc.0 publishes under next. Every command
and sentence now says @next, and the title names the release candidate.

Adds the two sections the guide was missing: the deploy builder
deprecation from angular#3803, and other notes (Node.js 20 unsupported,
TypeScript 6 config changes, the v21 migration re-running for release
candidate users, how a canary install moves to the release candidate).

Refs angular#3737
@armando-navarro armando-navarro added this to the 22.0.0-rc.0 milestone Oct 27, 2026
@armando-navarro armando-navarro added type: chore Maintenance with no user-facing behavior change. comp: docs Documentation. bump: patch Size of the change: a fix or docs change that reaches users labels Oct 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bump: patch Size of the change: a fix or docs change that reaches users comp: docs Documentation. type: chore Maintenance with no user-facing behavior change.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant