From 47fb38f4e0a47c6715b16248222d4dfefc256cf2 Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Mon, 14 Sep 2026 07:08:11 +0300 Subject: [PATCH 1/4] docs(glossary): rewrite grounded on reviewed translations Rebuild glossary from issue #418 reviewed pages: confirmed terms with source citations, disambiguation rules, and gap-fill proposals. Signed-off-by: Alessandro De Blasis Co-authored-by: Cursor --- GLOSSARY.md | 260 +++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 198 insertions(+), 62 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index 77d49fc5d..fada6fcb9 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -1,62 +1,198 @@ -# Glossary - -Glossary of the translations of technical and React-specific terms. - -## Untranslatable terms -- props (**core concept**) -- state (**core concept**) -- hooks (**core concept**) -- ref (**core concept**) -- footer -- bug -- browser -- client -- server -- array -- alert -- record -- true -- false -- tag -- lifecycle -- callback -- console -- warning -- form/forms -- render props -- strict mode -- web components -- build steps -- wrapper -- provider -- consumer -- context -- reducer - -# Common Translations - -Suggestion on words and terms: - -| Original word/term | Suggestion | -| ------------------ | ---------- | -| refactor | rifattorizzare | -| refactoring | rifattorizzazione | -| render | renderizzare (verbo), renderizzato (nome) | -| React component class | classe componente React | -| React component type | tipo componente React | -| function component | componente funzione | -| error boundary | contenitore di errori | - -## Problematic terms - -Here's a list of terms that require discussion/agreement, with a link to the issue. - -If you encounter one of those expressions for the first time, it might be worth checking the issue to find out what's the current quorum around how we should handle a consistent translation across the whole website. - -- `to render` ([#7](https://github.com/reactjs/it.reactjs.org/issues/7)) -- `React component class` ([#7](https://github.com/reactjs/it.reactjs.org/issues/7)) -- `React component type` ([#7](https://github.com/reactjs/it.reactjs.org/issues/7)) -- `refactor` ([#9](https://github.com/reactjs/it.reactjs.org/issues/9)) -- `event handler` ([#10](https://github.com/reactjs/it.reactjs.org/issues/10)) -- `event listener` ([#10](https://github.com/reactjs/it.reactjs.org/issues/10)) -- `mount` and `unmount` in sentences ([#108](https://github.com/reactjs/it.reactjs.org/issues/108)) +# Glossario + +Glossario dei termini tecnici e specifici di React per la traduzione italiana di [it.react.dev](https://it.react.dev). + +Le traduzioni in **Traduzioni confermate** derivano dalle pagine già tradotte e revisionate elencate in [#418](https://github.com/reactjs/it.react.dev/issues/418). In caso di dubbio, consulta quelle pagine prima di introdurre varianti. + +## Policy sugli anglicismi + +- **Non tradurre** identificatori API, nomi di codice e concetti core di React quando il loro uso in inglese è stabile nella community italiana (`props`, `state`, `hooks`, `ref`). +- **Traduci in prosa** quando esiste un equivalente italiano stabile e già adottato nel corpus (`renderizzare`, `gestore di eventi`, `istantanea`). +- **Mantieni in inglese** loanword tecnici senza equivalente univoco (`commit`, `dispatch`, `Suspense`, `prop drilling`). + +--- + +## Non tradurre + +Termini che restano in inglese in prosa e in codice. + +### Concetti core React + +| Termine | Note | +| ------- | ---- | +| props | Concetto core; articolo: *le props* | +| state | Concetto core; articolo: *lo state*. **Non** usare *stato* per il concetto React | +| hooks | Concetto core; es. *gli hooks*, *un Hook* | +| ref | Concetto core | +| context | Concetto core; es. *il context*, *un context* | +| reducer | Concetto core; es. *un reducer* | +| provider | Es. *un provider* | +| consumer | Es. *un consumer* | + +### Codice, API e identificatori + +| Termine | Note | +| ------- | ---- | +| callback | | +| console | | +| true / false | | +| tag | Attributi JSX | +| array | | +| record | Tipo TypeScript | +| form / forms | UI HTML | +| render props | Pattern React | +| strict mode | *Strict Mode* come nome proprio | +| web components | | +| build steps | | +| wrapper | | +| footer | UI | +| bug | | +| browser | | +| client / server | RSC | +| alert | API browser | +| warning | Messaggi React | +| lifecycle | Solo in nomi API; in prosa vedi *montare/smontare* | + +### Nomi di componenti, hook e API + +Non tradurre nomi di hook, componenti, metodi e proprietà: `useState`, `useEffect`, `createRoot`, `dispatch`, `Suspense`, ecc. + +--- + +## Traduzioni confermate + +Scelte adottate nelle pagine revisionate. La colonna **Fonte** indica la pagina di riferimento. + +### Pipeline di rendering + +| Inglese | Italiano | Fonte | +| ------- | -------- | ----- | +| to render | renderizzare | render-and-commit | +| rendering | renderizzazione | render-and-commit, conditional-rendering | +| re-render | ri-renderizzazione / renderizzare di nuovo | state-as-a-snapshot | +| initial render | renderizzazione iniziale | render-and-commit | +| commit (phase) | fase di commit | render-and-commit | +| trigger a render | avviare una renderizzazione | render-and-commit | +| update the DOM | aggiornare il DOM | render-and-commit | + +### Eventi + +| Inglese | Italiano | Fonte | +| ------- | -------- | ----- | +| event handler | gestore di eventi | responding-to-events | +| event handlers | gestori di eventi | responding-to-events | +| event listener | listener di eventi | you-might-not-need-an-effect (API DOM) | + +### State e dati + +| Inglese | Italiano | Fonte | +| ------- | -------- | ----- | +| state variable | variabile di state | state-a-components-memory | +| snapshot | istantanea | state-as-a-snapshot | +| lifting state up | sollevare lo state | tutorial-tic-tac-toe, passing-data-deeply-with-context | +| prop drilling | prop drilling | passing-data-deeply-with-context | +| batching | raggruppamento (degli aggiornamenti) | state-as-a-snapshot | +| memoization / to memoize | memorizzazione / memorizzare | you-might-not-need-an-effect | +| dispatch (action) | dispatch / eseguire il dispatch | extracting-state-logic-into-a-reducer | +| action (reducer) | azione | extracting-state-logic-into-a-reducer | +| controlled component | componente controllato | you-might-not-need-an-effect | +| uncontrolled component | componente non controllato | you-might-not-need-an-effect | +| one-way data flow | flusso di dati unidirezionale | thinking-in-react | + +### Mount e lifecycle (prosa) + +| Inglese | Italiano (prosa) | Inglese (API) | +| ------- | ---------------- | ------------- | +| mount | montare / montato | `mount` | +| unmount | smontare / smontato | `unmount` | +| remount | rimontare / rimontato | — | + +### Componenti e codice + +| Inglese | Italiano | Fonte | +| ------- | -------- | ----- | +| function component | componente funzione | glossary legacy | +| React component class | classe componente React | glossary legacy | +| React component type | tipo componente React | glossary legacy | +| error boundary | contenitore di errori | glossary legacy | +| refactor / refactoring | rifattorizzare / rifattorizzazione | glossary legacy | +| declarative | dichiarativo | thinking-in-react | +| imperative | imperativo | thinking-in-react | + +--- + +## Nomi propri React + +Usa la **maiuscola** quando ti riferisci al concetto React come nome proprio. + +| Inglese | Italiano | Fonte | +| ------- | -------- | ----- | +| Effect | Effetto | you-might-not-need-an-effect | +| Strict Mode | Strict Mode | — | +| Suspense | Suspense | — | +| Hook | Hook | state-a-components-memory | +| Transition | Transizione | — | +| Server Component | componente Server | proposta | +| Client Component | componente Client | proposta | + +Al plurale: *Effetti*, *Hooks*, *Transizioni* quando il concetto React resta nome proprio nel contesto. + +--- + +## Disambiguazioni + +| Termine | Quando | Traduzione | +| ------- | ------ | ---------- | +| Effect | Concetto React (`useEffect`, regole degli Effetti) | **Effetto** | +| side effect | Effetto collaterale generico in programmazione | **effetto collaterale** | +| effect (generico) | Non legato a `useEffect` | **effetto** (minuscolo) | +| state | Concetto React (variabili di state, aggiornare lo state) | **state** (mai *stato*) | +| stato | Stato generico non-React (es. "stato di un oggetto" in senso ampio) | solo se il contesto **non** è React state | +| render | Verbo/nome del processo React | **renderizzare / renderizzazione** | +| commit | Fase della pipeline React | **fase di commit** (loanword) | + +--- + +## Proposte per pagine non ancora tradotte + +Termini ricorrenti nel sorgente inglese per cui manca ancora un precedente nel corpus. Da confermare in review. + +| Inglese | Proposta | Note | +| ------- | -------- | ---- | +| dependency array | array di dipendenze | Effects | +| reconciliation | riconciliazione | Internals | +| hydration | hydration / idratazione | Preferire loanword *hydration* in contesto RSC | +| stale (closure/state) | obsoleto / stale | Mantenere *stale* se termine tecnico JS | +| fallback (Suspense) | fallback | UI Suspense | +| custom hook | custom hook | Pattern, non tradurre | +| dependency | dipendenza | Effects | +| subscription | sottoscrizione | Esterni | +| store (external) | store | Loanword | + +--- + +## Decisioni storiche + +Discussioni del vecchio [it.reactjs.org](https://github.com/reactjs/it.reactjs.org) che hanno informato le scelte attuali: + +- [render](https://github.com/reactjs/it.reactjs.org/issues/7) → *renderizzare* +- [event handler / listener](https://github.com/reactjs/it.reactjs.org/issues/10) → *gestore di eventi* +- [mount / unmount](https://github.com/reactjs/it.reactjs.org/issues/108) → *montare / smontare* in prosa +- [refactor](https://github.com/reactjs/it.reactjs.org/issues/9) → *rifattorizzare* + +--- + +## Pagine di riferimento per dominio + +| Dominio | Pagina | PR | +| ------- | ------ | -- | +| Eventi | responding-to-events | #438 | +| Rendering | render-and-commit | #446 | +| State (base) | state-a-components-memory | #439 | +| State (snapshot) | state-as-a-snapshot | #440 | +| State (struttura) | choosing-the-state-structure | #557 | +| Context | passing-data-deeply-with-context | #470 | +| Reducer | extracting-state-logic-into-a-reducer | — | +| Effetti | you-might-not-need-an-effect | — | +| Props | passing-props-to-a-component | #428 | +| Liste | rendering-lists | #442 | From eb9c989ef8dcdec142e7f36160bee56373607b96 Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Mon, 14 Sep 2026 07:13:50 +0300 Subject: [PATCH 2/4] docs(glossary): keep Effect as loanword, not Effetto MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Treat Effect like state/props/hooks — core concept stays in English. Note legacy Effetto usage in you-might-not-need-an-effect for community. Signed-off-by: Alessandro De Blasis Co-authored-by: Cursor --- GLOSSARY.md | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index fada6fcb9..a48ae0036 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -6,7 +6,7 @@ Le traduzioni in **Traduzioni confermate** derivano dalle pagine già tradotte e ## Policy sugli anglicismi -- **Non tradurre** identificatori API, nomi di codice e concetti core di React quando il loro uso in inglese è stabile nella community italiana (`props`, `state`, `hooks`, `ref`). +- **Non tradurre** identificatori API, nomi di codice e concetti core di React quando il loro uso in inglese è stabile nella community italiana (`props`, `state`, `hooks`, `ref`, `Effect`). - **Traduci in prosa** quando esiste un equivalente italiano stabile e già adottato nel corpus (`renderizzare`, `gestore di eventi`, `istantanea`). - **Mantieni in inglese** loanword tecnici senza equivalente univoco (`commit`, `dispatch`, `Suspense`, `prop drilling`). @@ -23,6 +23,7 @@ Termini che restano in inglese in prosa e in codice. | props | Concetto core; articolo: *le props* | | state | Concetto core; articolo: *lo state*. **Non** usare *stato* per il concetto React | | hooks | Concetto core; es. *gli hooks*, *un Hook* | +| Effect | Concetto core; es. *un Effect*, *gli Effect*. **Non** usare *Effetto* | | ref | Concetto core | | context | Concetto core; es. *il context*, *un context* | | reducer | Concetto core; es. *un reducer* | @@ -127,7 +128,6 @@ Usa la **maiuscola** quando ti riferisci al concetto React come nome proprio. | Inglese | Italiano | Fonte | | ------- | -------- | ----- | -| Effect | Effetto | you-might-not-need-an-effect | | Strict Mode | Strict Mode | — | | Suspense | Suspense | — | | Hook | Hook | state-a-components-memory | @@ -135,7 +135,7 @@ Usa la **maiuscola** quando ti riferisci al concetto React come nome proprio. | Server Component | componente Server | proposta | | Client Component | componente Client | proposta | -Al plurale: *Effetti*, *Hooks*, *Transizioni* quando il concetto React resta nome proprio nel contesto. +Al plurale: *Hooks*, *Transizioni* quando il concetto React resta nome proprio nel contesto. --- @@ -143,7 +143,7 @@ Al plurale: *Effetti*, *Hooks*, *Transizioni* quando il concetto React resta nom | Termine | Quando | Traduzione | | ------- | ------ | ---------- | -| Effect | Concetto React (`useEffect`, regole degli Effetti) | **Effetto** | +| Effect | Concetto React (`useEffect`, regole degli Effect) | **Effect** (loanword, come *state*) | | side effect | Effetto collaterale generico in programmazione | **effetto collaterale** | | effect (generico) | Non legato a `useEffect` | **effetto** (minuscolo) | | state | Concetto React (variabili di state, aggiornare lo state) | **state** (mai *stato*) | @@ -193,6 +193,6 @@ Discussioni del vecchio [it.reactjs.org](https://github.com/reactjs/it.reactjs.o | State (struttura) | choosing-the-state-structure | #557 | | Context | passing-data-deeply-with-context | #470 | | Reducer | extracting-state-logic-into-a-reducer | — | -| Effetti | you-might-not-need-an-effect | — | +| Effect | you-might-not-need-an-effect | — (pagina legacy: usa *Effetto*) | | Props | passing-props-to-a-component | #428 | | Liste | rendering-lists | #442 | From 5b699926f839c98e6d94b5b36681ff7d47369f90 Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Mon, 14 Sep 2026 07:22:46 +0300 Subject: [PATCH 3/4] docs(glossary): adopt Effetto from human-reviewed pages Revert Effect loanword policy; Effetto is the confirmed choice from you-might-not-need-an-effect and community review. Signed-off-by: Alessandro De Blasis Co-authored-by: Cursor --- GLOSSARY.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index a48ae0036..be19adc25 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -6,8 +6,8 @@ Le traduzioni in **Traduzioni confermate** derivano dalle pagine già tradotte e ## Policy sugli anglicismi -- **Non tradurre** identificatori API, nomi di codice e concetti core di React quando il loro uso in inglese è stabile nella community italiana (`props`, `state`, `hooks`, `ref`, `Effect`). -- **Traduci in prosa** quando esiste un equivalente italiano stabile e già adottato nel corpus (`renderizzare`, `gestore di eventi`, `istantanea`). +- **Non tradurre** identificatori API, nomi di codice e concetti core di React quando il loro uso in inglese è stabile nella community italiana (`props`, `state`, `hooks`, `ref`). +- **Traduci in prosa** quando esiste un equivalente italiano stabile e già adottato nel corpus (`renderizzare`, `gestore di eventi`, `Effetto`, `istantanea`). - **Mantieni in inglese** loanword tecnici senza equivalente univoco (`commit`, `dispatch`, `Suspense`, `prop drilling`). --- @@ -23,7 +23,6 @@ Termini che restano in inglese in prosa e in codice. | props | Concetto core; articolo: *le props* | | state | Concetto core; articolo: *lo state*. **Non** usare *stato* per il concetto React | | hooks | Concetto core; es. *gli hooks*, *un Hook* | -| Effect | Concetto core; es. *un Effect*, *gli Effect*. **Non** usare *Effetto* | | ref | Concetto core | | context | Concetto core; es. *il context*, *un context* | | reducer | Concetto core; es. *un reducer* | @@ -128,14 +127,15 @@ Usa la **maiuscola** quando ti riferisci al concetto React come nome proprio. | Inglese | Italiano | Fonte | | ------- | -------- | ----- | +| Effect | Effetto | you-might-not-need-an-effect | | Strict Mode | Strict Mode | — | | Suspense | Suspense | — | | Hook | Hook | state-a-components-memory | -| Transition | Transizione | — | +| Transition | Transizione | proposta | | Server Component | componente Server | proposta | | Client Component | componente Client | proposta | -Al plurale: *Hooks*, *Transizioni* quando il concetto React resta nome proprio nel contesto. +Al plurale: *Effetti*, *Hooks*, *Transizioni* quando il concetto React resta nome proprio nel contesto. --- @@ -143,7 +143,7 @@ Al plurale: *Hooks*, *Transizioni* quando il concetto React resta nome proprio n | Termine | Quando | Traduzione | | ------- | ------ | ---------- | -| Effect | Concetto React (`useEffect`, regole degli Effect) | **Effect** (loanword, come *state*) | +| Effect | Concetto React (`useEffect`, regole degli Effetti) | **Effetto** (nome proprio) | | side effect | Effetto collaterale generico in programmazione | **effetto collaterale** | | effect (generico) | Non legato a `useEffect` | **effetto** (minuscolo) | | state | Concetto React (variabili di state, aggiornare lo state) | **state** (mai *stato*) | @@ -193,6 +193,6 @@ Discussioni del vecchio [it.reactjs.org](https://github.com/reactjs/it.reactjs.o | State (struttura) | choosing-the-state-structure | #557 | | Context | passing-data-deeply-with-context | #470 | | Reducer | extracting-state-logic-into-a-reducer | — | -| Effect | you-might-not-need-an-effect | — (pagina legacy: usa *Effetto*) | +| Effetti | you-might-not-need-an-effect | — | | Props | passing-props-to-a-component | #428 | | Liste | rendering-lists | #442 | From 98a22a538bf98894bf912d8feadc9f7948c2142e Mon Sep 17 00:00:00 2001 From: Alessandro De Blasis Date: Mon, 14 Sep 2026 07:28:07 +0300 Subject: [PATCH 4/4] docs(glossary): fix false Fonte entries and add legacy section Move event listener and controlled/uncontrolled terms to proposte. Document legacy deviations in human-reviewed pages. Clarify that glossary choices follow the corpus without re-litigating them. Signed-off-by: Alessandro De Blasis Co-authored-by: Cursor --- GLOSSARY.md | 26 +++++++++++++++++++++----- 1 file changed, 21 insertions(+), 5 deletions(-) diff --git a/GLOSSARY.md b/GLOSSARY.md index be19adc25..382828b60 100644 --- a/GLOSSARY.md +++ b/GLOSSARY.md @@ -2,7 +2,9 @@ Glossario dei termini tecnici e specifici di React per la traduzione italiana di [it.react.dev](https://it.react.dev). -Le traduzioni in **Traduzioni confermate** derivano dalle pagine già tradotte e revisionate elencate in [#418](https://github.com/reactjs/it.react.dev/issues/418). In caso di dubbio, consulta quelle pagine prima di introdurre varianti. +Le traduzioni in **Traduzioni confermate** derivano dalle pagine già tradotte e revisionate elencate in [#418](https://github.com/reactjs/it.react.dev/issues/418). In caso di dubbio, consulta quelle pagine di riferimento — non introdurre varianti se esiste già una voce confermata. + +Le scelte riflettono il corpus umano così com'è: non riformuliamo decisioni già presenti nelle pagine revisionate. Se un termine diventa problematico in futuro, si aggiorna il glossario allora. ## Policy sugli anglicismi @@ -81,7 +83,6 @@ Scelte adottate nelle pagine revisionate. La colonna **Fonte** indica la pagina | ------- | -------- | ----- | | event handler | gestore di eventi | responding-to-events | | event handlers | gestori di eventi | responding-to-events | -| event listener | listener di eventi | you-might-not-need-an-effect (API DOM) | ### State e dati @@ -95,8 +96,6 @@ Scelte adottate nelle pagine revisionate. La colonna **Fonte** indica la pagina | memoization / to memoize | memorizzazione / memorizzare | you-might-not-need-an-effect | | dispatch (action) | dispatch / eseguire il dispatch | extracting-state-logic-into-a-reducer | | action (reducer) | azione | extracting-state-logic-into-a-reducer | -| controlled component | componente controllato | you-might-not-need-an-effect | -| uncontrolled component | componente non controllato | you-might-not-need-an-effect | | one-way data flow | flusso di dati unidirezionale | thinking-in-react | ### Mount e lifecycle (prosa) @@ -135,7 +134,7 @@ Usa la **maiuscola** quando ti riferisci al concetto React come nome proprio. | Server Component | componente Server | proposta | | Client Component | componente Client | proposta | -Al plurale: *Effetti*, *Hooks*, *Transizioni* quando il concetto React resta nome proprio nel contesto. +Al plurale: *Effetti*, *Hooks*, *Transizioni* quando il concetto React resta nome proprio nel contesto. La pagina canonica `you-might-not-need-an-effect` usa anche *effetti* minuscolo in prosa introduttiva — vedi [Pagine legacy](#pagine-legacy-con-deviazioni-note). --- @@ -159,6 +158,9 @@ Termini ricorrenti nel sorgente inglese per cui manca ancora un precedente nel c | Inglese | Proposta | Note | | ------- | -------- | ---- | +| event listener | listener di eventi | In prosa; in codice resta `addEventListener` | +| controlled component | componente controllato | | +| uncontrolled component | componente non controllato | | | dependency array | array di dipendenze | Effects | | reconciliation | riconciliazione | Internals | | hydration | hydration / idratazione | Preferire loanword *hydration* in contesto RSC | @@ -171,6 +173,20 @@ Termini ricorrenti nel sorgente inglese per cui manca ancora un precedente nel c --- +## Pagine legacy con deviazioni note + +Pagine revisionate da umani che **non seguono** tutte le regole attuali del glossario. Per **nuove traduzioni e revisioni**, segui il glossario — non replicare le deviazioni legacy. + +| Pagina | Deviazioni note | +| ------ | --------------- | +| you-might-not-need-an-effect | *stato* al posto di *state* (~22 occorrenze); *event handler* in inglese in alcuni passaggi; *effetti* minuscolo oltre a *Effetto*/*Effetti* | +| extracting-state-logic-into-a-reducer | *stato* al posto di *state* (~13 occorrenze) | +| scaling-up-with-reducer-and-context | *stato* al posto di *state* (~18 occorrenze) | + +La normalizzazione di queste pagine è opzionale e a cura della community, se mai. + +--- + ## Decisioni storiche Discussioni del vecchio [it.reactjs.org](https://github.com/reactjs/it.reactjs.org) che hanno informato le scelte attuali: