You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
fix(docs): revisiona community core e allinea sidebar
Corregge glossario, titoli e sidebar per index, translations,
docs-contributors e versioning-policy.
Signed-off-by: Alessandro De Blasis <alex@deblasis.net>
Co-authored-by: Cursor <cursoragent@cursor.com>
Copy file name to clipboardExpand all lines: src/content/community/index.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: Community React
2
+
title: La community di React
3
3
translationStatus: ai-draft
4
4
---
5
5
@@ -11,7 +11,7 @@ Questa pagina è stata tradotta automaticamente e supervisionata da un maintaine
11
11
12
12
<Intro>
13
13
14
-
React ha una community di milioni di developer. In questa pagina elenchiamo alcune community legate a React di cui puoi far parte; consulta le altre pagine di questa sezione per ulteriori materiali di apprendimento online e in presenza.
14
+
React ha una community di milioni di sviluppatori. In questa pagina elenchiamo alcune community legate a React di cui puoi far parte; consulta le altre pagine di questa sezione per ulteriori materiali di apprendimento online e in presenza.
Copy file name to clipboardExpand all lines: src/content/community/translations.md
+1-1Lines changed: 1 addition & 1 deletion
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,6 +37,6 @@ Per l'avanzamento di ciascuna traduzione, vedi: [Is React Translated Yet?](https
37
37
38
38
Puoi contribuire agli sforzi di traduzione!
39
39
40
-
La community conduce il lavoro di traduzione della documentazione di React su fork specifici per lingua di react.dev. Il lavoro tipico consiste nel tradurre direttamente un file Markdown e creare una pull request. Clicca il link "contribute" sopra per il repository GitHub della tua lingua e segui le istruzioni lì per aiutare con la traduzione.
40
+
La community conduce il lavoro di traduzione della documentazione di React su fork specifici per lingua di react.dev. Il lavoro tipico consiste nel tradurre direttamente un file Markdown e creare una pull request. Clicca il link «Contribuisci» sopra per il repository GitHub della tua lingua e segui le istruzioni lì per aiutare con la traduzione.
41
41
42
42
Se vuoi avviare una nuova traduzione per la tua lingua, visita: [translations.react.dev](https://github.com/reactjs/translations.react.dev)
Copy file name to clipboardExpand all lines: src/content/community/versioning-policy.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -41,22 +41,22 @@ Invece, rilasciamo nuove funzionalità nelle minor release. Ciò significa che l
41
41
42
42
### Impegno per la stabilità {/*commitment-to-stability*/}
43
43
44
-
Man mano che cambiamo React nel tempo, cerchiamo di minimizzare lo sforzo richiesto per sfruttare le nuove funzionalità. Quando possibile, manterremo funzionante una API più vecchia, anche se ciò significa metterla in un pacchetto separato. Ad esempio, [i mixin sono stati sconsigliati per anni](https://legacy.reactjs.org/blog/2016/07/13/mixins-considered-harmful.html) ma sono supportati ancora oggi [tramite create-react-class](https://legacy.reactjs.org/docs/react-without-es6.html#mixins) e molte codebase continuano a usarli in codice legacy stabile.
44
+
Man mano che cambiamo React nel tempo, cerchiamo di minimizzare lo sforzo richiesto per sfruttare le nuove funzionalità. Quando possibile, manterremo funzionante un'API più vecchia, anche se ciò significa metterla in un pacchetto separato. Ad esempio, [i mixin sono stati sconsigliati per anni](https://legacy.reactjs.org/blog/2016/07/13/mixins-considered-harmful.html) ma sono supportati ancora oggi [tramite create-react-class](https://legacy.reactjs.org/docs/react-without-es6.html#mixins) e molte codebase continuano a usarli in codice legacy stabile.
45
45
46
-
Oltre un milione di developer usano React, mantenendo collettivamente milioni di componenti. Il codebase di Facebook da solo ha oltre 50.000 componenti React. Ciò significa che dobbiamo rendere il più semplice possibile l'aggiornamento a nuove versioni di React; se facessimo grandi cambiamenti senza un percorso di migrazione, le persone resterebbero bloccate su vecchie versioni. Testiamo questi percorsi di aggiornamento su Facebook stesso — se il nostro team di meno di 10 persone può aggiornare da solo oltre 50.000 componenti, speriamo che l'aggiornamento sia gestibile per chiunque usi React. In molti casi, scriviamo [script automatizzati](https://github.com/reactjs/react-codemod) per aggiornare la sintassi dei componenti, che poi includiamo nella release open source per tutti.
46
+
Oltre un milione di sviluppatori usano React, mantenendo collettivamente milioni di componenti. Il codebase di Facebook da solo ha oltre 50.000 componenti React. Ciò significa che dobbiamo rendere il più semplice possibile l'aggiornamento a nuove versioni di React; se facessimo grandi cambiamenti senza un percorso di migrazione, le persone resterebbero bloccate su vecchie versioni. Testiamo questi percorsi di aggiornamento su Facebook stesso — se il nostro team di meno di 10 persone può aggiornare da solo oltre 50.000 componenti, speriamo che l'aggiornamento sia gestibile per chiunque usi React. In molti casi, scriviamo [script automatizzati](https://github.com/reactjs/react-codemod) per aggiornare la sintassi dei componenti, che poi includiamo nella release open source per tutti.
47
47
48
48
### Aggiornamenti graduali tramite warning {/*gradual-upgrades-via-warnings*/}
49
49
50
50
Le build di sviluppo di React includono molti warning utili. Quando possibile, aggiungiamo warning in preparazione per future breaking change. In questo modo, se la tua app non ha warning sull'ultima release, sarà compatibile con la prossima major release. Questo ti permette di aggiornare le tue app un componente alla volta.
51
51
52
-
I warning di sviluppo non influenzano il comportamento runtime della tua app. In questo modo, puoi essere sicuro che la tua app si comporterà allo stesso modo tra le build di sviluppo e produzione — le uniche differenze sono che la build di produzione non logga i warning ed è più efficiente. (Se mai notassi il contrario, per favore apri una issue.)
52
+
I warning di sviluppo non influenzano il comportamento runtime della tua app. In questo modo, puoi essere sicuro che la tua app si comporterà allo stesso modo tra le build di sviluppo e produzione — le uniche differenze sono che la build di produzione non logga i warning ed è più efficiente. (Se mai notassi il contrario, per favore apri un'issue.)
53
53
54
54
### Cosa conta come breaking change? {/*what-counts-as-a-breaking-change*/}
55
55
56
56
In generale, *non* incrementiamo il numero di major version per cambiamenti a:
57
57
58
58
***Warning di sviluppo.** Poiché non influenzano il comportamento in produzione, possiamo aggiungere nuovi warning o modificare quelli esistenti tra major version. In effetti, questo è ciò che ci permette di avvisare in modo affidabile sulle prossime breaking change.
59
-
***API che iniziano con `unstable_`.** Sono fornite come funzionalità sperimentali di cui non siamo ancora sicuri delle API. Rilasciandole con il prefisso `unstable_`, possiamo iterare più velocemente e arrivare prima a una API stabile.
59
+
***API che iniziano con `unstable_`.** Sono fornite come funzionalità sperimentali le cui API non sono ancora stabili. Rilasciandole con il prefisso `unstable_`, possiamo iterare più velocemente e arrivare prima a un'API stabile.
60
60
***Versioni Alpha e Canary di React.** Forniamo versioni alpha di React come modo per testare nuove funzionalità in anticipo, ma abbiamo bisogno della flessibilità di fare cambiamenti in base a ciò che impariamo nel periodo alpha. Se usi queste versioni, nota che le API possono cambiare prima della release stabile.
61
61
***API non documentate e strutture dati interne.** Se accedi a nomi di proprietà interne come `__SECRET_INTERNALS_DO_NOT_USE_OR_YOU_WILL_BE_FIRED` o `__reactInternalInstance$uk43rzhitjg`, non c'è garanzia. Sei solo.
62
62
@@ -70,9 +70,9 @@ Detto ciò, se ci aspettiamo che un cambiamento in questo elenco causi problemi
70
70
71
71
Tuttavia, solleva la domanda del perché queste release non siano versionate come patch.
72
72
73
-
La risposta è che qualsiasi cambiamento a React (o altro software) comporta un certo rischio di rompersi in modi inaspettati. Immagina uno scenario in cui una patch release che corregge un bug introduce accidentalmente un altro bug. Questo non sarebbe solo dirompente per i developer, ma danneggerebbe anche la loro fiducia nelle future patch release. È particolarmente deplorevole se la correzione originale è per un bug raramente incontrato nella pratica.
73
+
La risposta è che qualsiasi cambiamento a React (o altro software) comporta un certo rischio di rompersi in modi inaspettati. Immagina uno scenario in cui una patch release che corregge un bug introduce accidentalmente un altro bug. Questo non sarebbe solo dirompente per gli sviluppatori, ma danneggerebbe anche la loro fiducia nelle future patch release. È particolarmente deplorevole se la correzione originale è per un bug raramente incontrato nella pratica.
74
74
75
-
Abbiamo un track record piuttosto buono nel mantenere le release di React prive di bug, ma le patch release hanno una barra ancora più alta per l'affidabilità perché la maggior parte dei developer assume di poterle adottare senza conseguenze negative.
75
+
Abbiamo un buon storico nel mantenere le release di React prive di bug, ma le patch release hanno una barra ancora più alta per l'affidabilità perché la maggior parte degli sviluppatori assume di poterle adottare senza conseguenze negative.
76
76
77
77
Per questi motivi, riserviamo le patch release solo per i bug più critici e le vulnerabilità di sicurezza.
78
78
@@ -84,14 +84,14 @@ React si affida a una fiorente community open source per segnalare bug, aprire p
84
84
85
85
<Note>
86
86
87
-
Questa sezione sarà più rilevante per i developer che lavorano su framework, librerie o strumenti per developer. I developer che usano React principalmente per costruire applicazioni user-facing non dovrebbero doversi preoccupare dei nostri canali prerelease.
87
+
Questa sezione sarà più rilevante per gli sviluppatori che lavorano su framework, librerie o strumenti per sviluppatori. Gli sviluppatori che usano React principalmente per costruire applicazioni user-facing non dovrebbero doversi preoccupare dei nostri canali prerelease.
88
88
89
89
</Note>
90
90
91
91
Ciascuno dei canali di release di React è pensato per un caso d'uso distinto:
92
92
93
93
-[**Latest**](#latest-channel) è per le release stabili di React con semver. È ciò che ottieni quando installi React da npm. Questo è il canale che stai già usando oggi. **Le applicazioni user-facing che consumano React direttamente usano questo canale.**
94
-
-[**Canary**](#canary-channel) segue il branch main del repository sorgente di React. Pensale come release candidate per la prossima release semver. **[Framework o altri setup curati possono scegliere di usare questo canale con una versione di React fissata.](/blog/2023/05/03/react-canaries) Puoi anche usare le Canary per integration testing tra React e progetti di terze parti.**
94
+
-[**Canary**](#canary-channel) segue il branch main del repository sorgente di React. Considerale come release candidate per la prossima release semver. **[Framework o altri setup curati possono scegliere di usare questo canale con una versione di React fissata.](/blog/2023/05/03/react-canaries) Puoi anche usare le Canary per integration testing tra React e progetti di terze parti.**
95
95
-[**Experimental**](#experimental-channel) include API e funzionalità sperimentali non disponibili nelle release stabili. Seguono anche il branch main, ma con feature flag aggiuntive attivate. Usalo per provare funzionalità imminenti prima che vengano rilasciate.
96
96
97
97
Tutte le release sono pubblicate su npm, ma solo Latest usa il semantic versioning. Le prerelease (quelle nei canali Canary e Experimental) hanno versioni generate da un hash del loro contenuto e della data del commit, es. `18.3.0-canary-388686f29-20230503` per Canary e `0.0.0-experimental-388686f29-20230503` per Experimental.
@@ -127,10 +127,10 @@ Il canale Canary supporta anche l'integration testing tra React e altri progetti
127
127
128
128
Tutti i cambiamenti a React passano attraverso un testing interno estensivo prima di essere rilasciati al pubblico. Tuttavia, ci sono innumerevoli ambienti e configurazioni usate in tutto l'ecosistema React, e non è possibile per noi testare contro ognuno.
129
129
130
-
Se sei l'autore di un framework React, libreria, strumento per developer o progetto simile di tipo infrastrutturale, puoi aiutarci a mantenere React stabile per i tuoi utenti e l'intera community React eseguendo periodicamente la tua test suite contro i cambiamenti più recenti. Se sei interessato, segui questi passaggi:
130
+
Se sei l'autore di un framework React, libreria, strumento per sviluppatori o progetto simile di tipo infrastrutturale, puoi aiutarci a mantenere React stabile per i tuoi utenti e l'intera community React eseguendo periodicamente la tua test suite contro i cambiamenti più recenti. Se sei interessato, segui questi passaggi:
131
131
132
132
- Configura un cron job usando la tua piattaforma di continuous integration preferita. I cron job sono supportati sia da [CircleCI](https://circleci.com/docs/2.0/triggers/#scheduled-builds) che da [Travis CI](https://docs.travis-ci.com/user/cron-jobs/).
133
-
- Nel cron job, aggiorna i tuoi pacchetti React alla release React più recente nel canale Canary, usando il tag `canary` su npm. Con la cli npm:
133
+
- Nel cron job, aggiorna i tuoi pacchetti React alla release React più recente nel canale Canary, usando il tag `canary` su npm. Con la CLI npm:
134
134
135
135
```console
136
136
npm update react@canary react-dom@canary
@@ -143,7 +143,7 @@ Se sei l'autore di un framework React, libreria, strumento per developer o proge
143
143
```
144
144
- Esegui la tua test suite contro i pacchetti aggiornati.
145
145
- Se tutto passa, ottimo! Puoi aspettarti che il tuo progetto funzionerà con la prossima minor release di React.
146
-
- Se qualcosa si rompe inaspettatamente, faccelo sapere [aprendo una issue](https://github.com/react/react/issues).
146
+
- Se qualcosa si rompe inaspettatamente, faccelo sapere [aprendo un'issue](https://github.com/react/react/issues).
147
147
148
148
Un progetto che usa questo workflow è Next.js. Puoi fare riferimento alla loro [configurazione CircleCI](https://github.com/zeit/next.js/blob/c0a1c0f93966fe33edd93fb53e5fafb0dcd80a9e/.circleci/config.yml) come esempio.
0 commit comments