Skip to content

Commit f14a76b

Browse files
deblasiscursoragent
andcommitted
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>
1 parent 210d862 commit f14a76b

5 files changed

Lines changed: 23 additions & 23 deletions

File tree

‎src/content/community/docs-contributors.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -17,15 +17,15 @@ La documentazione di React è scritta e mantenuta dal [team React](/community/te
1717

1818
## Contenuti {/*content*/}
1919

20-
* [Rachel Nabors](https://twitter.com/RachelNabors): editing, scrittura, illustrazioni
20+
* [Rachel Nabors](https://twitter.com/RachelNabors): revisione, scrittura, illustrazioni
2121
* [Dan Abramov](https://bsky.app/profile/danabra.mov): scrittura, progettazione del curriculum
2222
* [Sylwia Vargas](https://twitter.com/SylwiaVargas): codice di esempio
2323
* [Rick Hanlon](https://twitter.com/rickhanlonii): scrittura
2424
* [David McCabe](https://twitter.com/mcc_abe): scrittura
2525
* [Sophie Alpert](https://twitter.com/sophiebits): scrittura
2626
* [Pete Hunt](https://twitter.com/floydophone): scrittura
2727
* [Andrew Clark](https://twitter.com/acdlite): scrittura
28-
* [Matt Carroll](https://twitter.com/mattcarrollcode): editing, scrittura
28+
* [Matt Carroll](https://twitter.com/mattcarrollcode): revisione, scrittura
2929
* [Natalia Tepluhina](https://twitter.com/n_tepluhina): revisioni, consigli
3030
* [Sebastian Markbåge](https://twitter.com/sebmarkbage): feedback
3131

‎src/content/community/index.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Community React
2+
title: La community di React
33
translationStatus: ai-draft
44
---
55

@@ -11,7 +11,7 @@ Questa pagina è stata tradotta automaticamente e supervisionata da un maintaine
1111

1212
<Intro>
1313

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.
1515

1616
</Intro>
1717

‎src/content/community/translations.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,6 +37,6 @@ Per l'avanzamento di ciascuna traduzione, vedi: [Is React Translated Yet?](https
3737

3838
Puoi contribuire agli sforzi di traduzione!
3939

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.
4141

4242
Se vuoi avviare una nuova traduzione per la tua lingua, visita: [translations.react.dev](https://github.com/reactjs/translations.react.dev)

‎src/content/community/versioning-policy.md‎

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -41,22 +41,22 @@ Invece, rilasciamo nuove funzionalità nelle minor release. Ciò significa che l
4141

4242
### Impegno per la stabilità {/*commitment-to-stability*/}
4343

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.
4545

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.
4747

4848
### Aggiornamenti graduali tramite warning {/*gradual-upgrades-via-warnings*/}
4949

5050
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.
5151

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.)
5353

5454
### Cosa conta come breaking change? {/*what-counts-as-a-breaking-change*/}
5555

5656
In generale, *non* incrementiamo il numero di major version per cambiamenti a:
5757

5858
* **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.
6060
* **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.
6161
* **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.
6262

@@ -70,9 +70,9 @@ Detto ciò, se ci aspettiamo che un cambiamento in questo elenco causi problemi
7070

7171
Tuttavia, solleva la domanda del perché queste release non siano versionate come patch.
7272

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.
7474

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.
7676

7777
Per questi motivi, riserviamo le patch release solo per i bug più critici e le vulnerabilità di sicurezza.
7878

@@ -84,14 +84,14 @@ React si affida a una fiorente community open source per segnalare bug, aprire p
8484

8585
<Note>
8686

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.
8888

8989
</Note>
9090

9191
Ciascuno dei canali di release di React è pensato per un caso d'uso distinto:
9292

9393
- [**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.**
9595
- [**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.
9696

9797
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
127127

128128
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.
129129

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:
131131

132132
- 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:
134134

135135
```console
136136
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
143143
```
144144
- Esegui la tua test suite contro i pacchetti aggiornati.
145145
- 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).
147147

148148
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.
149149

‎src/sidebarCommunity.json‎

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,13 +1,13 @@
11
{
2-
"title": "Comunità",
2+
"title": "Community",
33
"path": "/community",
44
"routes": [
55
{
66
"hasSectionHeader": true,
7-
"sectionHeader": "PARTECIPA"
7+
"sectionHeader": "GET INVOLVED"
88
},
99
{
10-
"title": "React Community",
10+
"title": "La community di React",
1111
"path": "/community",
1212
"skipBreadcrumb": true,
1313
"routes": [
@@ -28,19 +28,19 @@
2828
"path": "/community/team"
2929
},
3030
{
31-
"title": "Docs Contributors",
31+
"title": "Contributori alla documentazione",
3232
"path": "/community/docs-contributors"
3333
},
3434
{
35-
"title": "Translations",
35+
"title": "Traduzioni",
3636
"path": "/community/translations"
3737
},
3838
{
39-
"title": "Acknowledgements",
39+
"title": "Riconoscimenti",
4040
"path": "/community/acknowledgements"
4141
},
4242
{
43-
"title": "Versioning Policy",
43+
"title": "Politica di versionamento",
4444
"path": "/community/versioning-policy"
4545
}
4646
]

0 commit comments

Comments
 (0)