Skip to content

Commit 2ed9622

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 9f560e0 commit 2ed9622

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
@@ -207,6 +207,7 @@ Prima di aprire o approvare una PR di traduzione:
207207
- [ ] Nessun paragrafo rimasto in inglese
208208
- [ ] Link interni con path corretti
209209
- [ ] `yarn check-all` passa
210+
- [ ] Anteprima locale: pagina coerente con layout, sidebar, Note AI e Sandpack del resto del sito (vedi sotto)
210211

211212
### Verifica rapida termini
212213

@@ -217,6 +218,18 @@ Cerca varianti deprecate nel file tradotto:
217218
rg -i 'event handler|\\blo stato\\b|\\brendere\\b' src/content/learn/TUO-FILE.md
218219
```
219220

221+
### Anteprima nel browser
222+
223+
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`):
224+
225+
1. **Sidebar** — titolo aggiornato, sezione corretta, capitalizzazione *State* coerente con le voci vicine
226+
2. **Layout** — Intro, YouWillLearn, Recap, Challenges, Pitfall/Note/DeepDive renderizzati come le altre pagine Learn
227+
3. **Nota AI** — blocco `<Note>` visibile in cima, link "Migliora questa traduzione" funzionante
228+
4. **Sandpack** — esempi interattivi caricano ed eseguono; titoli UI possono restare in inglese
229+
5. **Link interni** — navigazione verso pagine correlate (capitolo precedente/successivo) senza 404
230+
231+
Segnala incoerenze visive o di tono rispetto al corpus umano prima di marcare la PR ready.
232+
220233
---
221234

222235
## 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)