i18n: add missing translations from initial full-repo pass#17888
Merged
i18n: add missing translations from initial full-repo pass#17888
Conversation
Adds WhitepaperBridge component, simplifies intro to single paragraph matching current English source. Removes outdated 3-paragraph intro and PDF link (now handled by component). Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>
myelinated-wackerow
requested review from
pettinarip and
wackerow
as code owners
✅ Deploy Preview for ethereumorg ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
github-actions
bot
added
content 🖋️
Collaborator
Author
There was a problem hiding this comment.
Translation Review: PR #17888
Reviewed by Claude (Opus 4.6)
42 files across 8 languages (ar, bn, de, id, it, sw, ta, ur)
Scoring Summary
| Category | Score |
|---|---|
| Structural integrity | 9/10 |
| HTML tag preservation | 9/10 |
| Technical term handling | 9/10 |
| Link preservation | 10/10 |
| Frontmatter correctness | 10/10 |
| Code block preservation | 6/10 |
| Component preservation | 10/10 |
| Translation quality | 8/10 |
| Composite | 8.9/10 |
Critical Issues (3 -- must fix before merge)
1. Swahili: Thai script corruption in src/intl/sw/glossary.json
Lines 160-161 and 191 contain Thai Unicode characters spliced into Swahili:
"fallback-function-term": "Fังก์ชัน mbadala"
Three entries affected: fallback-function-term, fallback-function-definition, hash-definition. These will render as garbled text.
2. Italian: Broken URLs + translated code in tutorial
File: public/content/translations/it/developers/tutorials/hello-world-smart-contract-fullstack/index.md
Broken URLs in code blocks:
- Line 665:
https: // goerli.etherscan.io/...(space breaks URL) - Line 925:
wss: // eth-goerli.ws.alchemyapi.io/...(space breaks URL)
Translated code comments (11+ instances):
Code blocks have inline comments translated to Italian. Examples:
// Avvia il deployment...(was// Start deployment...)// chiamato solo una volta(was//called only once)- Full Solidity contract at lines 1041-1065 has all comments in Italian
Malformed JSDoc:
- Line 275:
/* *instead of/**
Users copy-pasting code from this tutorial will get broken/inconsistent results.
3. German whitepaper: "Minder" typo + 4 others
File: public/content/translations/de/whitepaper/index.md
| Line | Found | Expected | Impact |
|---|---|---|---|
| 103 | Minder |
Miner |
Content-changing ("Minder" = "less" in German) |
| 23 | dezentralisiertee |
dezentralisierte |
Double-e typo |
| 119 | Sytem |
System |
Missing 's' |
| 92 | Sybill |
Sybil |
Extra 'l' |
| 113 | Dieser Steht |
Dieser steht |
Spurious capital |
Also: outdated URLs in notes section (HTTP instead of HTTPS for bitcoinmagazine, missing /library/ in nakamotoinstitute link).
Note: <WhitepaperBridge /> is correctly placed and the intro reads naturally aside from these typos.
Warning Issues (7)
- de/ethereum-forks line 371:
erhöhtshould beerhöhte(tense error) - bn/glossary.json line 2: Bengali numeral
৫১%-- project policy requires Western Arabic51% - ar/glossary.json:
gwei-termuses Arabic transliteration"جواي (Gwei)"-- should stay purely Latin per Wei/Gwei policy - ta/ethash + ur/ethash + ur/dagger-hashimoto: Python code comments inside fenced code blocks translated to Tamil/Urdu (no other language does this)
- de/learn-quizzes.json: Mixed du/Sie register throughout
- it tutorial: Frontmatter tags capitalized/translated vs lowercase English source
Clean files (29/42 passed with no issues)
- Indonesian (id): All 5 files clean -- excellent structural quality
- Bengali (bn): 6/7 clean (only glossary numeral issue)
- Tamil (ta): 10/12 clean (Wei fix is a positive improvement over prior state)
- Urdu (ur): 7/9 clean (good RTL handling,
<span dir="ltr">additions are correct) - Italian (it): 2/3 clean (glossary + quizzes fine, tutorial is the problem)
Pre-existing English source bugs (not introduced by this PR)
Three HTML bugs in src/intl/en/glossary.json are faithfully reproduced in all translated glossaries:
evm-assembly-language-definition: Missing</a>closing tagmessage-definition:</evm>instead of</a>contract-account-definition: Stray]inEOA]</a>
These should be fixed upstream in the English source.
Reviewed by Sentinel (Claude Opus 4.6)
- sw/glossary.json: replace Thai script corruption with correct Swahili in 3 glossary entries - de/whitepaper: fix typos (Minder->Miner, Sytem, Sybill, dezentralisiertee, capitalization), update outdated URLs to match English source - it/hello-world tutorial: fix broken URLs in code blocks (https: // -> https://), restore malformed JSDoc delimiter (/* * -> /**) Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com> Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>
Collaborator
Author
There was a problem hiding this comment.
Translation Review: PR #17888 (Updated)
Reviewed by Sentinel (Claude Opus 4.6)
42 files across 8 languages (ar, bn, de, id, it, sw, ta, ur)
Scoring Summary
| Category | Previous | Updated | Notes |
|---|---|---|---|
| Structural integrity | 9/10 | 10/10 | Thai corruption + JSDoc fixed |
| HTML tag preservation | 9/10 | 9/10 | Inherited EN bugs remain (separate PR) |
| Technical term handling | 9/10 | 9/10 | bn numeral + ar Gwei deferred to glossary sweep |
| Link preservation | 10/10 | 10/10 | |
| Frontmatter correctness | 10/10 | 10/10 | |
| Code block preservation | 6/10 | 9/10 | Broken URLs fixed; translated comments are by design |
| Component preservation | 10/10 | 10/10 | |
| Translation quality | 8/10 | 9/10 | German whitepaper typos fixed |
| Composite | 8.9/10 | 9.5/10 |
Critical Issues -- All Resolved
All 3 critical issues from the initial review have been fixed in 40d7d2bcb3:
Swahili Thai script corruption-- replaced with correct Swahili (kitendaji) in 3 glossary entriesItalian broken URLs in code blocks--https: //andwss: //fixed; malformed JSDoc/* *restored to/**German whitepaper typos-- 6 typos fixed (Minder->Miner, dezentralisiertee, Sytem, Sybill, capitalization, stray space) + 2 outdated URLs updated
Remaining warnings (deferred -- non-blocking)
These are tracked and will be addressed by glossary integration or follow-up PRs:
- bn/glossary.json: Bengali numeral
৫১%(glossary DNT entries will prevent in quality sweep) - ar/glossary.json: Gwei partially transliterated (same -- glossary sweep)
- de/ethereum-forks:
erhöht->erhöhtetense error - de/learn-quizzes.json: Mixed du/Sie register (content team decision)
- it tutorial: Frontmatter tag capitalization differs from EN source
- 3 inherited EN source bugs in glossary.json (
</evm>, missing</a>, stray]) -- affects all languages, needs upstream fix in separate PR
Clean files (29/42 passed with no issues)
- Indonesian (id): All 5 files clean -- excellent structural quality
- Bengali (bn): 6/7 clean
- Tamil (ta): 10/12 clean (Wei Latin fix is a positive improvement)
- Urdu (ur): 7/9 clean (good RTL handling)
- Italian (it): 2/3 clean
PR is merge-ready pending green Netlify build.
Reviewed by Claude (Opus 4.6)
wackerow
approved these changes
Mar 28, 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
2 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.
Description
Completes the initial full-repo translation pass by translating the ~30 file/language pairs that were not completed during the bulk translation effort.
Root causes and workflow fixes
Several pipeline issues were identified and fixed in #17836 (gemini-v3):
BLOCK_NONEsafety settings on all harm categoriespath.relative()for GitHub tree APILanguages
ar, bn, de, id, it, sw, ta, ur
Files
JSON (multiple languages):
src/intl/en/glossary.json(all above)src/intl/en/learn-quizzes.json(all above)src/intl/en/page-resources.json(bn)src/intl/en/page-trillion-dollar-security.json(bn)src/intl/en/page-what-is-the-ethereum-network.json(ur)Markdown (language-specific):
developers/docs/apis/json-rpc/index.md(bn, ta, ur)developers/docs/consensus-mechanisms/pow/mining/mining-algorithms/ethash/index.md(bn, ta, ur)developers/docs/consensus-mechanisms/poa/index.md(ta)developers/docs/consensus-mechanisms/pos/pos-vs-pow/index.md(ta)developers/docs/web2-vs-web3/index.md(ta)contributing/translation-program/translatathon/index.md(ta)ethereum-forks/index.md(bn, de, ur)roadmap/fusaka/peerdas/index.md(bn, ta, ur)roadmap/glamsterdam/index.md(id, ta)roadmap/merge/index.md(id)roadmap/pectra/maxeb/index.md(ta, ur)whitepaper/index.md(de) -- manual patch: added<WhitepaperBridge />component, updated intro textdevelopers/docs/nodes-and-clients/index.md(id)developers/tutorials/hello-world-smart-contract-fullstack/index.md(it)developers/docs/consensus-mechanisms/pow/mining/mining-algorithms/dagger-hashimoto/index.md(ur)developers/docs/dapps/index.md(ur)developers/tutorials/secret-state/index.md(ur)Test plan
Co-authored by Claude Opus 4.6