Skip to content

Commit e18e12d

Browse files
deblasiscursoragent
andcommitted
fix(learn): address review feedback for queueing state updates
Apply glossary/style fixes and document State capitalization in titles. Signed-off-by: Alessandro De Blasis <alex@deblasis.net> Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent b442af4 commit e18e12d

3 files changed

Lines changed: 14 additions & 5 deletions

File tree

STYLE_GUIDE.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -49,9 +49,12 @@ Segui la policy del [Glossario](./GLOSSARY.md#policy-sugli-anglicismi):
4949
| Contesto | Regola | Esempio |
5050
| -------- | ------ | ------- |
5151
| Concetti core React in prosa | minuscolo | *le props*, *lo state*, *gli hooks* |
52+
| Titoli (`title` nel frontmatter e sidebar) | **State** maiuscolo quando è il concetto React | `Aggiornare gli Oggetti nello State`, `Lo State come un'Istantanea` |
5253
| Nomi propri React | maiuscola | *Effetto*, *Strict Mode*, *Suspense*, *Hook* |
5354
| API e codice | come in inglese | `useState`, `createRoot` |
5455

56+
Nei **titoli di pagina e voci sidebar**, tratta *State* come nome proprio del concetto React e scrivilo con la maiuscola, anche in espressioni come *dello State* / *nello State*. Nel corpo del testo resta minuscolo: *lo state*, *dello state*.
57+
5558
### Coerenza obbligatoria
5659

5760
- **Non alternare** *state* e *stato* per lo stesso concetto React → sempre *state*
@@ -160,8 +163,14 @@ title: Renderizzare e Aggiornare
160163
---
161164
```
162165

166+
Se il titolo menziona il concetto React state, usa la maiuscola come in sidebar: `Lo State come un'Istantanea`, non `... dello state`.
167+
163168
Altri campi (`description`, ecc.) vanno tradotti se presenti.
164169

170+
### Titoli sidebar
171+
172+
Aggiorna `sidebarLearn.json` o `sidebarReference.json` insieme alla pagina. Il titolo sidebar deve coincidere con il `title` del frontmatter (stessa capitalizzazione). Segui le voci già tradotte nella stessa sezione: *State* maiuscolo nei titoli, minuscolo nel corpo.
173+
165174
---
166175

167176
## Traduzioni assistite (AI)

src/content/learn/queueing-a-series-of-state-updates.md

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Accodare più aggiornamenti dello state
2+
title: Accodare più aggiornamenti dello State
33
translationStatus: ai-draft
44
---
55

@@ -106,7 +106,7 @@ h1 { display: inline-block; margin: 10px; width: 30px; text-align: center; }
106106

107107
</Sandpack>
108108

109-
Qui, `n => n + 1` è chiamata una **funzione di aggiornamento.** Quando la passi a un setter dello state:
109+
Qui, `n => n + 1` è chiamata una **funzione di aggiornamento dello state.** Quando la passi a un setter dello state:
110110

111111
1. React mette in coda questa funzione per essere elaborata dopo che tutto il resto del codice nel gestore di eventi è stato eseguito.
112112
2. Durante la prossima renderizzazione, React attraversa la coda e ti restituisce lo state aggiornato finale.
@@ -253,7 +253,7 @@ Per riassumere, ecco come puoi pensare a ciò che passi al setter dello state `s
253253
* **Una funzione di aggiornamento** (es. `n => n + 1`) viene aggiunta alla coda.
254254
* **Qualsiasi altro valore** (es. il numero `5`) aggiunge "sostituisci con `5`" alla coda, ignorando ciò che è già in coda.
255255

256-
Dopo che il gestore di eventi termina, React innesca una ri-renderizzazione. Durante la ri-renderizzazione, React elabora la coda. Le funzioni di aggiornamento vengono eseguite durante la renderizzazione, quindi **le funzioni di aggiornamento devono essere [pure](/learn/keeping-components-pure)** e solo *restituire* il risultato. Non provare a impostare lo state al loro interno o eseguire altri effetti collaterali. In Strict Mode, React eseguirà ogni funzione di aggiornamento due volte (ma scarterà il secondo risultato) per aiutarti a trovare errori.
256+
Dopo che il gestore di eventi termina, React innesca una ri-renderizzazione. Durante la ri-renderizzazione, React elabora la coda. Le funzioni di aggiornamento vengono eseguite durante la renderizzazione, quindi **le funzioni di aggiornamento devono essere [puri](/learn/keeping-components-pure)** e solo *restituire* il risultato. Non provare a impostare lo state al loro interno o eseguire altri effetti collaterali. In Strict Mode, React eseguirà ogni funzione di aggiornamento due volte (ma scarterà il secondo risultato) per aiutarti a trovare errori.
257257

258258
### Convenzioni di denominazione {/*naming-conventions*/}
259259

@@ -271,7 +271,7 @@ Se preferisci codice più verboso, un'altra convenzione comune è ripetere il no
271271

272272
* Impostare lo state non cambia la variabile nella renderizzazione esistente, ma richiede una nuova renderizzazione.
273273
* React elabora gli aggiornamenti dello state dopo che i gestori di eventi hanno finito di essere eseguiti. Questo si chiama raggruppamento.
274-
* Per aggiornare uno state più volte in un evento, puoi usare la funzione di aggiornamento `setNumber(n => n + 1)`.
274+
* Per aggiornare lo state più volte in un evento, puoi usare la funzione di aggiornamento dello state `setNumber(n => n + 1)`.
275275

276276
</Recap>
277277

src/sidebarLearn.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -148,7 +148,7 @@
148148
"path": "/learn/state-as-a-snapshot"
149149
},
150150
{
151-
"title": "Accodare più aggiornamenti dello state",
151+
"title": "Accodare più aggiornamenti dello State",
152152
"path": "/learn/queueing-a-series-of-state-updates"
153153
},
154154
{

0 commit comments

Comments
 (0)