Repository navigation
docs(i18n): retranslate the changed AUTHZ_GUIDE and REMOTE-MODE sections in all 66 locales - #17098
Merged
diegosouzapw merged 1 commit intoOct 18, 2026
Conversation
…ons in all 66 locales The translation backend the docs pipeline calls is down (Vercel DEPLOYMENT_NOT_FOUND), so the mirrors of both guides still said that disabling login lets anyone mint an admin CLI token and issue sync tokens. The five sections that changed since the last run (Two Auth Modes, Route Classes and Auth Required Toggle; Managing tokens and Configuring a coding CLI) were translated outside the pipeline and then written by scripts/i18n/run-translation.mjs itself against a local stand-in for /chat/completions that answers with those translations. Section reuse, the chunk validator, glossary normalization, the mirror header and .i18n-state.json are therefore the pipeline's own output; the unchanged sections are byte-identical to before. The pipeline formats mirrors without the repo's Prettier config (printWidth 80 instead of 100), which re-wrapped one reused code line in the pl AUTHZ mirror; it is formatted back at the repo width and that entry's target_hash re-recorded to match. tests/unit/docs/remote-token-privilege-locales.test.ts now passes (part of the inherited red set). Refs #15306
Contributor
CI Coverage Report
Coverage artifact was not available for this run. |
This was referenced Oct 19, 2026
diegosouzapw
added a commit
that referenced
this pull request
Oct 19, 2026
Conflicts (265 files) resolved as follows: - AUTHZ_GUIDE + REMOTE-MODE mirrors (132): taken from the release tip. #17098 retranslated them against the current English sources (8c41f49e / 6602f4c9), which the tip state records; the PR side was translated from the older base sources and carried no section the tip did not also retranslate. The tip REMOTE-MODE also removes the duplicated privilege paragraph (64 locales). - README mirrors (58 conflicted + 8 auto-merged): PR translation kept, plus the tip's mechanical migration-count bump (204 -> 208) in the Database row. - QUALITY_GATES mirrors (66): PR translation kept, plus the tip's #15682 update of the `check:cycles` row (fail-closed since #15281). - .i18n-state.json: three-way merge per entry; AUTHZ_GUIDE and REMOTE-MODE entries from the tip; README and QUALITY_GATES keep the PR's source and section hashes with target_hash re-hashed to the merged mirror bytes. No other entry conflicted.
This was referenced Oct 19, 2026
diegosouzapw
added a commit
that referenced
this pull request
Oct 19, 2026
Merged via /merge-batch (2026-10-19). Evidence (owner asked to verify and merge, 2026-10-19): scope is only docs/i18n mirrors of 20 sources x 66 locales + .i18n-state.json (no protected surfaces, catalogs or baselines). Merged with the base three times; 265 conflicts resolved (AUTHZ_GUIDE/REMOTE-MODE from #17098 taken from the base, README and QUALITY_GATES keep this translation plus the base one-line deltas, state merged entry by entry with every mirror matching its recorded hash). Content audit of 1,320 mirrors: no leaked think tags, duplicated paragraphs or broken headers; code-span drift vs current sources 118 (base 272); the one regression found (Hausa SEARCH_TOOLS_STUDIO Tabs heading) fixed on top. check:docs-all, i18n ratio/keys, openapi/api-docs gates, typecheck core + open-sse green; 266/269 mirror tests, the 3 reds fail identically on the base. Known follow-ups (not certified as fresh in the state): GUARDRAILS after #17111, RESILIENCE_GUIDE after #12743, ENVIRONMENT hold.
diegosouzapw
added a commit
that referenced
this pull request
Oct 19, 2026
…17129) formatMarkdown() in scripts/i18n/run-translation.mjs formatted each translated mirror with Prettier's defaults (80 columns) instead of the options the prettier --write CLI resolves for the same path (prettier.config.mjs + .editorconfig, printWidth 100). lint-staged then re-wrapped code fences at commit time, and the committed mirror no longer matched the target_hash recorded in .i18n-state.json. It now resolves the config for the target path with prettier.resolveConfig(fileName, { editorconfig: true }) and formats with it. Refs #17098
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
The docs translation pipeline's backend is down (
cloud.omniroute.onlineanswers VercelDEPLOYMENT_NOT_FOUND), so the 66 locale mirrors ofdocs/architecture/AUTHZ_GUIDE.mdanddocs/guides/REMOTE-MODE.mdkept the previous open-mode text: they still said that disablinglogin lets anyone mint an
adminCLI token and issue sync tokens (changed in #17053 and #17064).The sections that changed since the last translation run were translated outside the pipeline and
then written by
scripts/i18n/run-translation.mjsitself, pointed at a local stand-in for/chat/completionsthat answers each chunk with its translation:AUTHZ_GUIDE.mdREMOTE-MODE.mdSection reuse, the chunk validator (
validateTranslatedChunk: fences, table rows, meta-prose),glossary normalization, the mirror header and language bar, Prettier and
.i18n-state.jsonaretherefore the pipeline's own output. Every unchanged section is byte-identical to before (checked
for all 132 mirrors).
One manual touch: the pipeline formats mirrors with Prettier's defaults instead of the repo
config (
printWidth80 vs 100), which re-wrapped one reused code line in theplAUTHZ mirror.It is formatted back at the repo width and that entry's
target_hashre-recorded. Worth aseparate change: resolve the repo config in
formatMarkdown().Validation
targets preserved, code blocks unchanged outside
#///comments, heading levels, trailing---, no English prose line left verbatim, and the literals the locale test requires.tests/unit/docs/remote-token-privilege-locales.test.tsnow passes (it was part of theinherited red set).
.i18n-state.jsonordocs/i18n: 266/269. The 3 failures(
resilience mirror provenance…,the two source-delta mirror records…,vision bridge key scope…) are inherited and fail with the same hashes on the base CI; theyconcern other docs.
check-translation-drift: both guides are gone from the drifted list.check-docs-syncPASS,Prettier clean, and every state entry's
source_hash/target_hashmatches the files.Refs #15306