chore: update origin to 4d985a179e (Angular v22.1.1) - #1197
Open
lacolaco wants to merge 59 commits into
Open
Conversation
lacolaco
force-pushed
the
update-origin-4d985a179e
branch
from
August 8, 2026 13:42
6162645 to
3bdb071
Compare
…/guide/forms/signals
…/introduction/essentials
…arn-angular/intro
…n-angular/steps/19-creating-an-injectable-service
…arn-angular/steps/25-next-steps
…gnal-forms/steps/6-next-steps
…gnals/steps/11-next-steps
…ials/signals/steps/7-using-signals-with-services
…/guide/components
…/guide/directives
lacolaco
force-pushed
the
update-origin-4d985a179e
branch
from
August 8, 2026 13:59
3bdb071 to
bfe5410
Compare
Angular v22.1 adds a link validator to the API docs rendering pipeline
(validateGuideUrl). It resolves every guide link with a fragment against
the anchors the page actually exposes. Japanese headings without an
explicit {#id} generate a Japanese-text ID, so 42 links from upstream
JsDoc no longer resolved and the build failed.
Anchor IDs are derived from the English heading at the same line index.
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.
Summary
Sync angular-ja with upstream angular/angular @
4d985a179e.Target selection: the release tag
22.1.0was not the commit serving production. angular.dev reportsv22.1.1+sha-4d985a1in its footer, so this PR syncs to that commit (4d985a179e, on the22.1.xbranch), consistent with how v22.0.0 was synced tofa546f382drather than the tag.Scope
88 markdown files and 4 source files were updated against the new upstream English.
Rebased onto
mainafter #1174 and #1176 merged.guide/aria/comboboxwas newly translated by #1176; its translation is kept and only its## APIssection was migrated to match, the same change applied to the other aria pages here.tutorials/first-app/steps/05-inputsfrom #1174 needed no change.Notable content changes:
guide/aria/*(12 pages): upstream replaced the hand-written## APIstables with a compact## API referencelink listreference/releases: release cadence updated (12-month major cycle, 24-month support window, v22.1 to v23.0 schedule)app/features/update/recommendations: 4 new migration steps translated, plushttp:tohttps:link correctionsguide/directives/structural-directives: the<docs-workflow>scaffold was consolidated into a single example, and the section was retranslatedreference/roadmap: in-progress entries moved into "Completed projects", with previously translated completed entries preservedapp/routing/navigation-entries: navigation badges refreshed and the new Signal Forms pages registeredRemoved / moved pages
None. Every
.en.*file inadev-ja/(309) still has an upstream counterpart, and upstream deleted no localized page in this range.Untranslated / deferred
New pages copied untranslated:
guide/forms/signals/dynamic-forms-with-json.mdguide/forms/signals/testing.mdreference/errors/NG0318.md,NG02825.md,NG05101.md,NG05102.md,NG05201.md,NG05703.mdPages rewritten upstream past the point where the prior translation could be adapted. These are reset to upstream English, with the previous translation kept as
.md.bakfor re-translation:ai/mcp-server-setup.md: IDE-specific sections removed, "Common Workflows" addedguide/directives/attribute-directives.md: three sections deleted upstreamguide/directives/overview.md: NgClass/NgStyle content removed upstreamPages where the existing translation was kept and newly added upstream sections were inserted as untranslated English, pending follow-up translation:
guide/components/inputs,guide/directives/directive-composition-api,guide/forms/signals/custom-controls,guide/forms/signals/field-state-management,guide/signals/linked-signal,guide/signals/resource,guide/ssr,guide/templates/pipes,guide/testing/attribute-directives,introduction/essentials/signal-formsAnchor IDs on translated headings
v22.1 adds a link validator to the API docs rendering pipeline. It resolves every guide link carrying a fragment against the anchors the target page actually exposes, and the build now fails on the first unresolved one. A Japanese heading without an explicit
{#id}generates an ID from its Japanese text, so 42 links coming from upstream JsDoc stopped resolving.These links were already unresolvable before this sync. The validator is what is new, so the breakage surfaces here.
Fixed by adding 153 explicit anchor IDs across 19 pages, each derived from the English heading at the same line index. One pre-existing anchor in
guide/security.mdwas corrected from#sanitization-and-security-contextto the plural form the English heading produces. Nothing else in these pages changed, and line counts are unaffected.Incidental fixes
Three pre-existing defects were found in files inside the sync scope and repaired so that the Japanese pages line up with their English sources again. None were introduced by this sync:
guide/testing/attribute-directives.md: a closing```fence was missing, leaving a code block unterminatedguide/components/inputs.md: legacy<docs-code language="ts">wrapper where upstream uses a fenced blockbest-practices/style-guide.md: paragraph line wrapping was offset by one line against the English source, with the text itself unchangedTest plan
pnpm test, all 9 localization patches (12 target files) apply to the new originpnpm lint.en.*/ translated pairsindexName: 'angular_jp_v19'fixed value preserved inreplace-environment-values.patch