Skip to content

i18n: Gemini translations (it)#17841

Merged
wackerow merged 7 commits into
devfrom
i18n/it-03-24T1602
Mar 25, 2026
Merged

i18n: Gemini translations (it)#17841
wackerow merged 7 commits into
devfrom
i18n/it-03-24T1602

Conversation

@wackerow
Copy link
Copy Markdown
Member

Description

This PR contains automated Gemini translations via Gemini.

🔗 View workflow run

Languages translated

it

JSON changes (src/intl/{locale}/)

  • app-subcategories.json
  • common.json
  • component-whitepaper.json
  • glossary-tooltip.json
  • page-10-year-anniversary.json
  • page-about.json
  • page-apps.json
  • page-assets.json
  • page-bug-bounty.json
  • page-collectibles.json
  • page-community-events.json
  • page-community-support.json
  • page-community.json
  • page-contributing-translation-program-acknowledgements.json
  • page-contributing-translation-program-contributors.json
  • page-developers-docs.json
  • page-developers-index.json
  • page-developers-tools.json
  • page-developers-tutorials.json
  • page-energy-consumption.json
  • page-ethereum-history-founder-and-ownership.json
  • page-ethereum-vs-bitcoin.json
  • page-founders.json
  • page-gas.json
  • page-get-eth.json
  • page-history.json
  • page-index.json
  • page-layer-2-learn.json
  • page-layer-2-networks.json
  • page-layer-2.json
  • page-learn.json
  • page-resources.json
  • page-roadmap-vision.json
  • page-roadmap.json
  • page-run-a-node.json
  • page-stablecoins.json
  • page-staking-deposit-contract.json
  • page-staking.json
  • page-start.json
  • page-trillion-dollar-security.json
  • page-upgrades-get-involved.json
  • page-upgrades-index.json
  • page-upgrades.json
  • page-wallets-find-wallet.json
  • page-wallets.json
  • page-what-is-ether.json
  • page-what-is-ethereum.json
  • page-what-is-the-ethereum-network.json
  • table.json
  • template-usecase.json

Markdown changes (public/content/translations/{locale}/)

  • about/index.md
  • ai-agents/index.md
  • bridges/index.md
  • community/code-of-conduct/index.md
  • community/events/organizing/index.md
  • community/get-involved/index.md
  • community/grants/index.md
  • community/language-resources/index.md
  • community/online/index.md
  • community/research/index.md
  • community/support/faq/index.md
  • community/support/misconceptions/index.md
  • community/support/scams/index.md
  • contributing/adding-desci-projects/index.md
  • contributing/adding-developer-tools/index.md
  • contributing/adding-exchanges/index.md
  • contributing/adding-glossary-terms/index.md
  • contributing/adding-layer-2s/index.md
  • contributing/adding-products/index.md
  • contributing/adding-resources/index.md
  • contributing/adding-staking-products/index.md
  • contributing/adding-wallets/index.md
  • contributing/content-resources/index.md
  • contributing/design-principles/index.md
  • contributing/design/adding-design-resources/index.md
  • contributing/design/index.md
  • contributing/index.md
  • contributing/quizzes/index.md
  • contributing/translation-program/faq/index.md
  • contributing/translation-program/how-to-translate/index.md
  • contributing/translation-program/index.md
  • contributing/translation-program/mission-and-vision/index.md
  • contributing/translation-program/playbook/index.md
  • contributing/translation-program/resources/index.md
  • contributing/translation-program/translatathon/details/index.md
  • contributing/translation-program/translatathon/index.md
  • contributing/translation-program/translators-guide/index.md
  • dao/index.md
  • decentralized-identity/index.md
  • defi/index.md
  • desci/index.md
  • developers/docs/accounts/index.md
  • developers/docs/apis/backend/index.md
  • developers/docs/apis/javascript/index.md
  • developers/docs/apis/json-rpc/index.md
  • developers/docs/blocks/index.md
  • developers/docs/bridges/index.md
  • developers/docs/consensus-mechanisms/index.md
  • developers/docs/consensus-mechanisms/poa/index.md
  • developers/docs/consensus-mechanisms/pos/attack-and-defense/index.md
  • developers/docs/consensus-mechanisms/pos/attestations/index.md
  • developers/docs/consensus-mechanisms/pos/block-proposal/index.md
  • developers/docs/consensus-mechanisms/pos/faqs/index.md
  • developers/docs/consensus-mechanisms/pos/gasper/index.md
  • developers/docs/consensus-mechanisms/pos/index.md
  • developers/docs/consensus-mechanisms/pos/keys/index.md
  • developers/docs/consensus-mechanisms/pos/pos-vs-pow/index.md
  • developers/docs/consensus-mechanisms/pos/rewards-and-penalties/index.md
  • developers/docs/consensus-mechanisms/pos/weak-subjectivity/index.md
  • developers/docs/consensus-mechanisms/pos/withdrawal-credentials/index.md
  • developers/docs/consensus-mechanisms/pow/index.md
  • developers/docs/consensus-mechanisms/pow/mining/index.md
  • developers/docs/consensus-mechanisms/pow/mining/mining-algorithms/dagger-hashimoto/index.md
  • developers/docs/consensus-mechanisms/pow/mining/mining-algorithms/ethash/index.md
  • developers/docs/consensus-mechanisms/pow/mining/mining-algorithms/index.md
  • developers/docs/dapps/index.md
  • developers/docs/data-and-analytics/block-explorers/index.md
  • developers/docs/data-and-analytics/index.md
  • developers/docs/data-availability/blockchain-data-storage-strategies/index.md
  • developers/docs/data-availability/index.md
  • developers/docs/data-structures-and-encoding/index.md
  • developers/docs/data-structures-and-encoding/patricia-merkle-trie/index.md
  • developers/docs/data-structures-and-encoding/rlp/index.md
  • developers/docs/data-structures-and-encoding/ssz/index.md
  • developers/docs/data-structures-and-encoding/web3-secret-storage/index.md
  • developers/docs/design-and-ux/dex-design-best-practice/index.md
  • developers/docs/design-and-ux/heuristics-for-web3/index.md
  • developers/docs/design-and-ux/index.md
  • developers/docs/development-networks/index.md
  • developers/docs/ethereum-stack/index.md
  • developers/docs/evm/index.md
  • developers/docs/evm/opcodes/index.md
  • developers/docs/frameworks/index.md
  • developers/docs/gas/index.md
  • developers/docs/ides/index.md
  • developers/docs/index.md
  • developers/docs/intro-to-ether/index.md
  • developers/docs/intro-to-ethereum/index.md
  • developers/docs/mev/index.md
  • developers/docs/networking-layer/index.md
  • developers/docs/networking-layer/network-addresses/index.md
  • developers/docs/networking-layer/portal-network/index.md
  • developers/docs/networks/index.md
  • developers/docs/nodes-and-clients/archive-nodes/index.md
  • developers/docs/nodes-and-clients/bootnodes/index.md
  • developers/docs/nodes-and-clients/client-diversity/index.md
  • developers/docs/nodes-and-clients/index.md
  • developers/docs/nodes-and-clients/light-clients/index.md
  • developers/docs/nodes-and-clients/node-architecture/index.md
  • developers/docs/nodes-and-clients/nodes-as-a-service/index.md
  • developers/docs/nodes-and-clients/run-a-node/index.md
  • developers/docs/oracles/index.md
  • developers/docs/programming-languages/dart/index.md
  • developers/docs/programming-languages/delphi/index.md
  • developers/docs/programming-languages/dot-net/index.md
  • developers/docs/programming-languages/elixir/index.md
  • developers/docs/programming-languages/golang/index.md
  • developers/docs/programming-languages/index.md
  • developers/docs/programming-languages/java/index.md
  • developers/docs/programming-languages/javascript/index.md
  • developers/docs/programming-languages/python/index.md
  • developers/docs/programming-languages/ruby/index.md
  • developers/docs/programming-languages/rust/index.md
  • developers/docs/scaling/index.md
  • developers/docs/scaling/optimistic-rollups/index.md
  • developers/docs/scaling/plasma/index.md
  • developers/docs/scaling/sidechains/index.md
  • developers/docs/scaling/state-channels/index.md
  • developers/docs/scaling/validium/index.md
  • developers/docs/scaling/zk-rollups/index.md
  • developers/docs/smart-contracts/anatomy/index.md
  • developers/docs/smart-contracts/compiling/index.md
  • developers/docs/smart-contracts/composability/index.md
  • developers/docs/smart-contracts/deploying/index.md
  • developers/docs/smart-contracts/formal-verification/index.md
  • developers/docs/smart-contracts/index.md
  • developers/docs/smart-contracts/languages/index.md
  • developers/docs/smart-contracts/libraries/index.md
  • developers/docs/smart-contracts/naming/index.md
  • developers/docs/smart-contracts/security/index.md
  • developers/docs/smart-contracts/testing/index.md
  • developers/docs/smart-contracts/upgrading/index.md
  • developers/docs/smart-contracts/verifying/index.md
  • developers/docs/standards/index.md
  • developers/docs/standards/tokens/erc-1155/index.md
  • developers/docs/standards/tokens/erc-1363/index.md
  • developers/docs/standards/tokens/erc-20/index.md
  • developers/docs/standards/tokens/erc-223/index.md
  • developers/docs/standards/tokens/erc-4626/index.md
  • developers/docs/standards/tokens/erc-721/index.md
  • developers/docs/standards/tokens/erc-777/index.md
  • developers/docs/standards/tokens/index.md
  • developers/docs/storage/index.md
  • developers/docs/transactions/index.md
  • developers/docs/web2-vs-web3/index.md
  • developers/tutorials/a-developers-guide-to-ethereum-part-one/index.md
  • developers/tutorials/ai-trading-agent/index.md
  • developers/tutorials/all-you-can-cache/index.md
  • developers/tutorials/app-plasma/index.md
  • developers/tutorials/calling-a-smart-contract-from-javascript/index.md
  • developers/tutorials/creating-a-wagmi-ui-for-your-contract/index.md
  • developers/tutorials/deploying-your-first-smart-contract/index.md
  • developers/tutorials/develop-and-test-dapps-with-a-multi-client-local-eth-testnet/index.md
  • developers/tutorials/downsizing-contracts-to-fight-the-contract-size-limit/index.md
  • developers/tutorials/eip-1271-smart-contract-signatures/index.md
  • developers/tutorials/erc-721-vyper-annotated-code/index.md
  • developers/tutorials/erc20-annotated-code/index.md
  • developers/tutorials/erc20-with-safety-rails/index.md
  • developers/tutorials/ethereum-for-web2-auth/index.md
  • developers/tutorials/gasless/index.md
  • developers/tutorials/getting-started-with-ethereum-development-using-alchemy/index.md
  • developers/tutorials/guide-to-smart-contract-security-tools/index.md
  • developers/tutorials/hello-world-smart-contract/index.md
  • developers/tutorials/how-to-implement-an-erc721-market/index.md
  • developers/tutorials/how-to-mint-an-nft/index.md
  • developers/tutorials/how-to-mock-solidity-contracts-for-testing/index.md
  • developers/tutorials/how-to-use-echidna-to-test-smart-contracts/index.md
  • developers/tutorials/how-to-use-manticore-to-find-smart-contract-bugs/index.md
  • developers/tutorials/how-to-use-slither-to-find-smart-contract-bugs/index.md
  • developers/tutorials/how-to-use-tellor-as-your-oracle/index.md
  • developers/tutorials/how-to-view-nft-in-metamask/index.md
  • developers/tutorials/how-to-write-and-deploy-an-nft/index.md
  • developers/tutorials/interact-with-other-contracts-from-solidity/index.md
  • developers/tutorials/ipfs-decentralized-ui/index.md
  • developers/tutorials/kickstart-your-dapp-frontend-development-with-create-eth-app/index.md
  • developers/tutorials/learn-foundational-ethereum-topics-with-sql/index.md
  • developers/tutorials/logging-events-smart-contracts/index.md
  • developers/tutorials/merkle-proofs-for-offline-data-integrity/index.md
  • developers/tutorials/monitoring-geth-with-influxdb-and-grafana/index.md
  • developers/tutorials/nft-minter/index.md
  • developers/tutorials/optimism-std-bridge-annotated-code/index.md
  • developers/tutorials/reverse-engineering-a-contract/index.md
  • developers/tutorials/run-node-raspberry-pi/index.md
  • developers/tutorials/scam-token-tricks/index.md
  • developers/tutorials/secret-state/index.md
  • developers/tutorials/secure-development-workflow/index.md
  • developers/tutorials/send-token-ethersjs/index.md
  • developers/tutorials/sending-transactions-using-web3-and-alchemy/index.md
  • developers/tutorials/server-components/index.md
  • developers/tutorials/set-up-web3js-to-use-ethereum-in-javascript/index.md
  • developers/tutorials/short-abi/index.md
  • developers/tutorials/smart-contract-security-guidelines/index.md
  • developers/tutorials/stealth-addr/index.md
  • developers/tutorials/the-graph-fixing-web3-data-querying/index.md
  • developers/tutorials/token-integration-checklist/index.md
  • developers/tutorials/transfers-and-approval-of-erc-20-tokens-from-a-solidity-smart-contract/index.md
  • developers/tutorials/understand-the-erc-20-token-smart-contract/index.md
  • developers/tutorials/uniswap-v2-annotated-code/index.md
  • developers/tutorials/using-websockets/index.md
  • developers/tutorials/yellow-paper-evm/index.md
  • eips/index.md
  • energy-consumption/index.md
  • eth/supply/index.md
  • ethereum-forks/index.md
  • foundation/index.md
  • gaming/index.md
  • glossary/index.md
  • governance/index.md
  • guides/how-to-create-an-ethereum-account/index.md
  • guides/how-to-id-scam-tokens/index.md
  • guides/how-to-revoke-token-access/index.md
  • guides/how-to-swap-tokens/index.md
  • guides/how-to-use-a-bridge/index.md
  • guides/how-to-use-a-wallet/index.md
  • guides/index.md
  • nft/index.md
  • payments/index.md
  • prediction-markets/index.md
  • privacy/index.md
  • real-world-assets/index.md
  • refi/index.md
  • restaking/index.md
  • roadmap/account-abstraction/index.md
  • roadmap/beacon-chain/index.md
  • roadmap/danksharding/index.md
  • roadmap/dencun/index.md
  • roadmap/fusaka/index.md
  • roadmap/fusaka/peerdas/index.md
  • roadmap/future-proofing/index.md
  • roadmap/glamsterdam/index.md
  • roadmap/merge/index.md
  • roadmap/merge/issuance/index.md
  • roadmap/pbs/index.md
  • roadmap/pectra/7702/index.md
  • roadmap/pectra/index.md
  • roadmap/pectra/maxeb/index.md
  • roadmap/scaling/index.md
  • roadmap/secret-leader-election/index.md
  • roadmap/security/index.md
  • roadmap/single-slot-finality/index.md
  • roadmap/statelessness/index.md
  • roadmap/user-experience/index.md
  • roadmap/verkle-trees/index.md
  • security/index.md
  • smart-contracts/index.md
  • social-networks/index.md
  • staking/dvt/index.md
  • staking/pools/index.md
  • staking/saas/index.md
  • staking/solo/index.md
  • staking/withdrawals/index.md
  • web3/index.md
  • what-are-apps/index.md
  • whitepaper/index.md
  • wrapped-eth/index.md
  • zero-knowledge-proofs/index.md

@netlify
Copy link
Copy Markdown

netlify Bot commented Mar 24, 2026

Deploy Preview for ethereumorg ready!

Name Link
🔨 Latest commit 14cb676
🔍 Latest deploy log https://app.netlify.com/projects/ethereumorg/deploys/69c32a20bc8b970008ab7c96
😎 Deploy Preview https://deploy-preview-17841.ethereum.it
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
Lighthouse
Lighthouse
7 paths audited
Performance: 58 (🟢 up 6 from production)
Accessibility: 94 (no change from production)
Best Practices: 100 (no change from production)
SEO: 98 (🔴 down 1 from production)
PWA: 59 (no change from production)
View the detailed breakdown and full score reports

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added content 🖋️ This involves copy additions or edits translation 🌍 This is related to our Translation Program labels Mar 24, 2026
@github-actions
Copy link
Copy Markdown
Contributor

🌐 Translation review started. View progress

@claude
Copy link
Copy Markdown
Contributor

claude Bot commented Mar 24, 2026

Translation Quality Review

PR: 17841 | Language: it (Italian) | Files reviewed: 305 | Date: 2026-03-24

Scores by Section:

  • Community/Contributing Pages: 9.7/10 (38 files, 0 critical) - Excellent quality
  • Developer Docs: 9.1/10 (20 sampled, 2 critical) - Code divergence in anatomy file
  • Developer Tutorials: 7.2/10 (20 sampled, 12 critical) - NatSpec corruption + translated skill fields
  • Content Pages: 9.5/10 (25 sampled, 0 critical) - All high-risk files clean
  • JSON Intl Files: 9.6/10 (49 files, 0 critical) - No contamination or artifacts

Critical Issues (14 total)

1. NatSpec Comment Corruption (6 files, 90 instances)
Solidity NatSpec opening corrupted (space inserted between stars) during translation.

  • tutorials/optimism-std-bridge-annotated-code/index.md (54)
  • tutorials/erc20-annotated-code/index.md (28)
  • tutorials/short-abi/index.md (5)
  • tutorials/scam-token-tricks/index.md (1)
  • tutorials/how-to-write-and-deploy-an-nft/index.md (1)
  • tutorials/eip-1271-smart-contract-signatures/index.md (1)

2. Translated skill Frontmatter (12 files)
Must remain in English (beginner/intermediate/advanced).

  • principiante to beginner: deploying-your-first-smart-contract, understand-the-erc-20-token-smart-contract, server-components, how-to-use-tellor-as-your-oracle
  • intermedio to intermediate: uniswap-v2-annotated-code, gasless, transfers-and-approval-of-erc-20-tokens, logging-events-smart-contracts, guide-to-smart-contract-security-tools, downsizing-contracts, secure-development-workflow
  • avanzato to advanced: interact-with-other-contracts-from-solidity

3. Code Block Divergence (1 file)
developers/docs/smart-contracts/anatomy/index.md - Missing Solidity ExampleDapp; uses SimpleToken instead of CryptoPizza.


Warnings (8 total)

  • page-staking.json: Uses La Fusione vs The Merge elsewhere
  • page-ethereum-history-founder-and-ownership.json: Wrong meta description (source bug)
  • page-resources.json: Wrong MEV-Boost description (source bug)
  • page-trillion-dollar-security.json: Lorem ipsum placeholder (source bug)
  • energy-consumption/index.md: Il Merge in image alt
  • staking/solo/index.md: slashing/punire inconsistency
  • consensus-mechanisms/pow/index.md: mina il sistema pun
  • Multiple tutorial files: Concept tags translated to Italian

Overall: High-quality Italian translation. Issues are mechanical (NatSpec corruption, translated skill fields) not translation quality. Non-tutorial content scores 9.5+/10.


Reviewed by Claude Code

myelinated-wackerow and others added 4 commits March 24, 2026 18:55
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>
Broaden quoteFrontmatterNonAscii to also quote values
containing colon-space or space-hash, which break YAML
parsing. Adds 3 tests, documents pattern #47.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>
collapseInlineHtmlFromEnglish was matching across
code fences and crossing newlines via \s*, collapsing
unrelated </div> tags. Add code fence protection and
use [ \t]* instead of \s* for closing tag whitespace.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: wackerow <54227730+wackerow@users.noreply.github.com>
@github-actions github-actions Bot added documentation 📖 Change or add documentation tooling 🔧 Changes related to tooling of the project labels Mar 25, 2026
Copy link
Copy Markdown
Collaborator

@myelinated-wackerow myelinated-wackerow left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Translation Quality Review

PR: #17841
Language: Italian (it)
Files reviewed: 305 (256 MD + 49 JSON)
Date: 2026-03-25

Quality Scores - Italian (it) - 9.1/10

Category Score Notes
MDX Syntax Safety 10/10 All MDX components properly structured. URLs with parens correctly wrapped. No raw < in prose.
Href Integrity 10/10 50+ internal links spot-checked, all use English paths. No translated routes.
Structural Match 10/10 Header counts match English. Frontmatter clean. Code fences balanced.
Brand Name Preservation 9/10 All brands preserved. Two upstream "Consensys" casing issues (from English source).
Technical Accuracy 9/10 Glossary terms correctly used throughout. One minor untranslated "proof-of-stake" instance.
Terminology Consistency 9/10 All 27 glossary terms verified across 200+ files.
Semantic Fidelity 9/10 Faithful translations. No semantic inversions. Natural Italian phrasing.
Tone/Register 7/10 Consistently informal "tu" (good), but translators-guide claims formal policy (pre-existing mismatch).

Critical Issues: None

No must-fix issues found. All build-breaking problems (YAML quoting, frontmatter protection) resolved by sanitizer.

Warnings (Non-Blocking)
File Issue Details
translators-guide/index.md Register policy mismatch Guide says "formal" but all content uses informal "tu" -- pre-existing
nodes-and-clients/index.md:21 Untranslated term "proof-of-stake" left in English once; translated correctly elsewhere
prediction-markets/index.md:36 Minor phrasing "Decentralizzazione" as card title vs "Decentralizzato"
energy-consumption/index.md Naming inconsistency "Il Merge" vs "The Merge" mixed within file
zk-rollups/index.md, golang/index.md "Consensys" casing Upstream from English source (should be "ConsenSys")
Review Methodology
  • 3 specialized review agents (Structural, Terminology, Semantic) deployed in parallel
  • Structural: MDX syntax, hrefs, code blocks, frontmatter validation
  • Terminology: Brand names, glossary compliance (27 community-voted terms), ticker symbols
  • Semantic: Meaning preservation, tone/register, untranslated content detection
  • Sanitizer: post-import sanitization applied (55 files auto-fixed)

Reviewed by Claude Opus 4.6

@wackerow wackerow merged commit 59ea4e6 into dev Mar 25, 2026
8 checks passed
@wackerow wackerow deleted the i18n/it-03-24T1602 branch March 25, 2026 00:44
@wackerow
Copy link
Copy Markdown
Member Author

Translation Failures:

  • it:public/content/developers/tutorials/hello-world-smart-contract-fullstack/index.md
  • it:src/intl/en/glossary.json
  • it:src/intl/en/learn-quizzes.json

Noting for follow-up task

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content 🖋️ This involves copy additions or edits documentation 📖 Change or add documentation tooling 🔧 Changes related to tooling of the project translation 🌍 This is related to our Translation Program

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants