Skip to content

Commit 785bc2e

Browse files
deblasiscursoragent
andcommitted
fix(learn): address review feedback for referencing values with refs
Clarify latest state wording and add browser preview step to style guide. Signed-off-by: Alessandro De Blasis <alex@deblasis.net> Co-authored-by: Cursor <cursoragent@cursor.com>
1 parent a9d639f commit 785bc2e

2 files changed

Lines changed: 16 additions & 3 deletions

File tree

‎STYLE_GUIDE.md‎

Lines changed: 13 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -198,6 +198,7 @@ Prima di aprire o approvare una PR di traduzione:
198198
- [ ] Nessun paragrafo rimasto in inglese
199199
- [ ] Link interni con path corretti
200200
- [ ] `yarn check-all` passa
201+
- [ ] Anteprima locale: pagina coerente con layout, sidebar, Note AI e Sandpack del resto del sito (vedi sotto)
201202

202203
### Verifica rapida termini
203204

@@ -208,6 +209,18 @@ Cerca varianti deprecate nel file tradotto:
208209
rg -i 'event handler|\\blo stato\\b|\\brendere\\b' src/content/learn/TUO-FILE.md
209210
```
210211

212+
### Anteprima nel browser
213+
214+
Dopo `yarn dev`, controlla la pagina tradotta e confrontala con una pagina italiana già revisionata nella stessa sezione (es. `state-as-a-snapshot`, `responding-to-events`):
215+
216+
1. **Sidebar** — titolo aggiornato, sezione corretta, capitalizzazione *State* coerente con le voci vicine
217+
2. **Layout** — Intro, YouWillLearn, Recap, Challenges, Pitfall/Note/DeepDive renderizzati come le altre pagine Learn
218+
3. **Nota AI** — blocco `<Note>` visibile in cima, link "Migliora questa traduzione" funzionante
219+
4. **Sandpack** — esempi interattivi caricano ed eseguono; titoli UI possono restare in inglese
220+
5. **Link interni** — navigazione verso pagine correlate (capitolo precedente/successivo) senza 404
221+
222+
Segnala incoerenze visive o di tono rispetto al corpus umano prima di marcare la PR ready.
223+
211224
---
212225

213226
## Riferimenti

‎src/content/learn/referencing-values-with-refs.md‎

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -584,11 +584,11 @@ button { display: block; margin: 10px; }
584584

585585
</Solution>
586586

587-
#### Leggere l'ultimo state {/*read-the-latest-state*/}
587+
#### Leggere lo state più recente {/*read-the-latest-state*/}
588588

589589
In questo esempio, dopo aver premuto "Send", c'è un piccolo ritardo prima che il messaggio venga mostrato. Digita "hello", premi Send, e poi modifica rapidamente l'input di nuovo. Nonostante le tue modifiche, l'alert mostrerebbe comunque "hello" (che era il valore dello state [al momento](/learn/state-as-a-snapshot#state-over-time) in cui è stato cliccato il bottone).
590590

591-
Di solito, questo comportamento è quello che vuoi in un'app. Tuttavia, ci possono essere casi occasionali in cui vuoi che del codice asincrono legga l'*ultima* versione di uno state. Riesci a pensare a un modo per far sì che l'alert mostri il testo *corrente* dell'input piuttosto che quello che era al momento del click?
591+
Di solito, questo comportamento è quello che vuoi in un'app. Tuttavia, ci possono essere casi occasionali in cui vuoi che del codice asincrono legga l'*ultima* versione dello state. Riesci a pensare a un modo per far sì che l'alert mostri il testo *corrente* dell'input piuttosto che quello che era al momento del click?
592592

593593
<Sandpack>
594594

@@ -623,7 +623,7 @@ export default function Chat() {
623623

624624
<Solution>
625625

626-
Lo state funziona [come un'istantanea](/learn/state-as-a-snapshot), quindi non puoi leggere l'ultimo state da un'operazione asincrona come un timeout. Tuttavia, puoi conservare l'ultimo testo dell'input in un ref. Un ref è mutabile, quindi puoi leggere la proprietà `current` in qualsiasi momento. Poiché il testo corrente viene anche usato per la renderizzazione, in questo esempio avrai bisogno *sia* di una variabile di state (per la renderizzazione), *sia* di un ref (per leggerlo nel timeout). Dovrai aggiornare manualmente il valore corrente del ref.
626+
Lo state funziona [come un'istantanea](/learn/state-as-a-snapshot), quindi non puoi leggere lo state più recente da un'operazione asincrona come un timeout. Tuttavia, puoi conservare l'ultimo testo dell'input in un ref. Un ref è mutabile, quindi puoi leggere la proprietà `current` in qualsiasi momento. Poiché il testo corrente viene anche usato per la renderizzazione, in questo esempio avrai bisogno *sia* di una variabile di state (per la renderizzazione), *sia* di un ref (per leggerlo nel timeout). Dovrai aggiornare manualmente il valore corrente del ref.
627627

628628
<Sandpack>
629629

0 commit comments

Comments
 (0)