Repository navigation
docs: document the 22.0.0-rc.1 changes - #3835
Draft
armando-navarro wants to merge 4 commits into
Draft
armando-navarro wants to merge 4 commits into
armando-navarro wants to merge 4 commits into
Conversation
docs/zones.md says callback APIs hold the app unstable until an initial value, so a server render waits for data. angular#3827 makes a set of calls exceptions because their first callback may never come. Waiting on a callback that never comes would keep the app from ever becoming stable. List those calls in docs/zones.md, and point at onValue, object, list, listVal and fromRef with the value event as the calls that still make a server render wait. In docs/database.md, say the same under stateChanges, auditTrail and fromRef. Refs angular#3826
angular#3831 lets AngularFire 22 accept firebase 12 or 13, and the ng update migration now writes the range of the firebase major already installed. The upgrade guide still said the migration writes ^12.18.0 and quoted peer warnings that name only that range. State the supported range and what the migration writes, update the Yarn 1 and pnpm 9/10 warnings to their current wording, and add a section on moving to firebase 13: VertexAIBackend is removed and its packages declare Node 24.12 or later. Refs angular#3830
angular#3833 moves every Observable read from a setInterval timer to the next microtask checkpoint. As a breaking change it needs a section in the upgrade guide: which tests now see a value they used to wait for, the setTimeout ordering flip, and the zoneless server render case for hand-written TransferState entries. Refs angular#3832
angular#3837 removes a callback read's pending task right after the callback instead of one setTimeout(fn, 0) delay later. As a breaking change it needs a section in the upgrade guide: what moves sooner, and which tests notice. Refs angular#3836
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Fixes #3834
This is the one docs PR for
22.0.0-rc.1. It stays a draft until the release.Why one docs PR per release
mainshows on GitHub as the current docs immediately, while the behavior it describes ships only in canaries until the next tagged release.How it works
22.0.0-rc.1that changes documented behavior does not carry the docs itself, and they get no PR of their own. They go here as one commit, added when the code PR is filed, and the code PR's description points here.22.0.0-rc.1tag, after the last code PR it describes, so the docs onmainand the published package change together.Commits so far
docs: say which wrapped calls do not hold the app unstable, for fix: stop twelve wrapped calls from holding the app unstable #3827: lists indocs/zones.mdthe wrapped calls that do not hold the app unstable, and adds one sentence each understateChanges,auditTrailandfromRefindocs/database.md.docs: describe firebase 13 support in the v22 upgrade guide, for feat: accept firebase 13 alongside firebase 12 #3831: states the supported range^12.18.0 || ^13.0.0and whatng updatewrites indocs/version-22-upgrade.md, updates the Yarn 1 and pnpm warning quotes, and adds a section on moving to firebase 13.docs: describe microtask delivery in the v22 upgrade guide, for feat(zones)!: deliver Observable read values as microtasks #3833: adds a section todocs/version-22-upgrade.mdon Observable reads delivering at the next microtask checkpoint instead of after a timer, with the test-timing,setTimeoutordering and zoneless server render notes.docs: describe the callback pending-task change in the v22 upgrade guide, for feat(zones)!: remove callback pending tasks right after the callback #3837: adds a section todocs/version-22-upgrade.mdon callback reads removing Angular's pending task right after the callback instead of onesetTimeout(fn, 0)delay later:whenStable()and server rendering follow a callback read's first value onesetTimeout(fn, 0)delay sooner, and a test that inspects pending tasks directly sees the task gone without a timer advance while a test awaitingwhenStable()under fake timers still needs the advance.Checklist
yarn install,yarn testrun successfully?: not applicable, docs only.