docs: Brazilian Portuguese, Simplified Chinese and Italian translations of the core guides - #15739
Merged
Merged
Conversation
246 pages of the core guide set, applied with the integrity gates (fences, headings, shortcodes and link targets verified against the English source) and wired into the language switcher. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
246 pages of the core guide set, applied with the integrity gates (fences, headings, shortcodes and link targets verified against the English source) and wired into the language switcher. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
246 pages of the core guide set, applied with the integrity gates (fences, headings, shortcodes and link targets verified against the English source) and wired into the language switcher. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
blakeaowens
approved these changes
Aug 19, 2026
Maffooch
approved these changes
Aug 19, 2026
github-merge-queue
Bot
removed this pull request from the merge queue due to failed status checks
Aug 19, 2026
github-merge-queue
Bot
removed this pull request from the merge queue due to failed status checks
Aug 20, 2026
github-merge-queue
Bot
removed this pull request from the merge queue due to failed status checks
Aug 20, 2026
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
3 participants
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.
Adds Brazilian Portuguese, Simplified Chinese and Italian translations of the core guide set, continuing the multilingual work from #15627 (German) and the Spanish, French and Japanese pages already in
bugfix.What is here
<page>.pt-br.md,<page>.zh-hans.md,<page>.it.md)docs/i18n/<lang>.toml,docs/config/_default/menus/menus.<lang>.toml)languages.tomlonly after its content is on disk, so the switcher never offers an empty localeNo English page is modified and no existing translation is touched.
How it was checked
Each language passed the pipeline's integrity gates before being applied. The gates compare every translated page against its English source and fail the page unless the code fences are byte-identical (including fences that are indented or inside a blockquote), the heading levels appear in the same order, and every shortcode and link target survives with only link text translated. Brand, scanner and parser names, CVE/CWE/CVSS identifiers, file paths, URLs, CLI commands, environment variables and code identifiers are left in English.
On this branch, against current
bugfix:Worth knowing for review
These are machine translations that have been integrity-checked, not reviewed by native speakers. The structure, code and links are verified; the wording is not. A native-speaker pass is a separate step.
The translated pages were produced from a snapshot of the English guides, so a page whose English has changed very recently may lag. Refresh passes are planned to close that gap rather than holding the languages back.
🤖 Generated with Claude Code