Update and add Italian translations

docs/contributing/contributing.it.md

@@ -0,0 +1,57 @@
+# Contribuire a Vapor
+
+Vapor è un progetto gestito dalla community e le contribuzioni dai membri della community formano una parte significante dello sviluppo di Vapor. Questa guida ti aiuterà a capire il processo di contribuzione e aiutarti a fare i tuoi primi commit in Vapor!
+
+Qualsiasi contributo darai sarà utile! Anche le piccole cose come aggiustare errori di battitura fanno la differenza per le persone che usano Vapor.
+
+## Codice di Condotta
+
+Vapor ha adottato il Codice di Condotta di Swift che puoi trovare su [https://www.swift.org/code-of-conduct/](https://www.swift.org/code-of-conduct/). Tutti i contributori devono seguire il codice di condotta.
+
+## Su cosa lavorare
+
+Capire su cosa lavorare può essere un grande ostacolo quando sei agli inizi nell'open source! Di solito le cose migliori su cui lavorare sono problemi che incontri o funzionalità che vuoi. Tuttavia, Vapor ha delle cose utili per aiutarti a contribuire.
+
+### Problemi di sicurezza
+
+Se scopri un problema di sicurezza e vuoi riferirlo o aiutare a risolverlo perfavore **non** creare una issue o una pull request. Abbiamo un processo separato per i problemi di sicurezza per assicurare che non esponiamo vulnerabilità finché una soluzione non è disponibile. Manda una email a [email protected] o [guarda qui](https://github.com/vapor/.github/blob/main/SECURITY.md) per più dettagli.
+
+### Piccoli problemi
+
+Se trovi un piccolo problema, bug o errore di battitura, sentiti libero di procedere e creare una pull request per risolverlo. Se risolve una issue aperta su una qualsiasi delle repo puoi linkarla nella pull request nella barra laterale in modo che la issue viene automaticamente chiusa quando la pull request viene unita.
+
+![GitHub Link Issue](../images/github-link-issue.png)
+
+### Nuove funzionalità
+
+Se vuoi proporre cambiamenti più grandi, come nuove funzionalità o bug fix che cambiano quantità significative di codice, allora perfavore apri una issue prima o fai un post nel canale `#development` di Discord. Questo ci permette di discutere il cambiamento con te in quanto potrebbe esserci del contesto che dobbiamo applicare o possiamo darti delle indicazioni. Non vogliamo farti perdere tempo se una funzionalità non rientra nei nostri piani!
+
+### Bacheca di Vapor
+
+Se vuoi solo contribuire ma non hai idea su cosa lavorare, fantastico! Vapor ha un paio di bacheche che possono aiutarti. Vapor ha circa 40 repository che sono attivamente sviluppate e cercare fra tutte queste per trovare qualcosa su cui lavorare non è fattibile, quindi delle bacheche per aggregarle.
+
+La prima bachecha è la [bacheca delle buone prime issue](https://github.com/orgs/vapor/projects/10). Ogni issue nell'organizzazione GitHub di Vapor che è taggata come `good first issue` sarà aggiunta alla bacheca. Queste sono issue che pensiamo possano essere buone per persone relativamente nuove a Vapor per lavorarci su, in quanto non richiedono molta esperienza sul codice.
+
+La seconda bacheca è la [bacheca dell'aiuto cercasi](https://github.com/orgs/vapor/projects/11). Questa contiene issue taggate `help wanted`. Queste sono issue che potrebbero essere aggiustate, ma la squadra principale al momento ha altre priorità. Queste issue di solito richiedono un po' più di conoscenza se non sono anche taggate `good first issue`, ma potrebbero essere un progetto divertente su cui lavorare!
+
+### Traduzioni
+
+L'area finale in cui le contribuzioni sono estremamente importanti è la documentazione. La documentazione ha traduzioni per diverse lingue, ma non tutte le pagine sono tradotte e ci sono molte altre lingue che ci piacerebbe supportare! Se sei interessato a contribuire con nuove lingue o aggiornamenti guarda il [README della documentazione](https://github.com/vapor/docs#translating) o fatti sentire nel canale `#documentation` su Discord.
+
+## Processo di Contribuzione
+
+Se non hai mai lavorato ad un progetto open source, i passi per contribuire effettivamente potrebbero sembrare confusionari, ma sono molto semplici.
+
+Primo, forka Vapor o qualsiasi repo sulla quale vuoi lavorare. Puoi farlo nell'interfaccia GitHub e GitHub ha [un'ottima documentazione](https://docs.github.com/en/get-started/quickstart/fork-a-repo) su come farlo.
+
+A questo punto puoi fare cambiamenti nella tua fork con il solito processo di commit e push. Quando sei pronto a presentare i tuoi cambiamenti, puoi creare una PR sulla repo di Vapor. Di nuovo, GitHub ha [un'ottima documentazione](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request-from-a-fork) su come farlo.
+
+## Presentare una Pull Request
+
+Quando presenti una pull request delle cose che dovresti controllare:
+
+* Che tutti i test passino
+* Che ci siano nuovi test aggiunti per ogni nuovo comportamento o bug fixato
+* Che le nuove API pubbliche siano documentate. Usiamo DocC per la documentazione delle nostre API.
+
+Vapor usa automazioni per ridurre il carico di lavoro richiesto per molti compiti. Per le pull requests, usiamo il [Bot Vapor](https://github.com/VaporBot) per generare release quando una pull request è unita. Il corpo e il titolo della pull request sono usati per generare le note sulla versione, quindi assicurati che abbiano senso e mettici quello che ti aspetti di vedere in una nota sulla versione. Ci sono più dettagli sulle [linee guida alla contribuzione di Vapor](https://github.com/vapor/vapor/blob/main/.github/contributing.md#release-title).

docs/getting-started/folder-structure.it.md

@@ -1,6 +1,6 @@
-# Struttura della Cartella
+# Struttura delle Cartelle
 
-Dopo aver creato, compilato ed eseguito la vostra prima applicazione, è il momento di dare un'occhiata a come Vapor struttura la cartella del progetto. La struttura si basa su [SwiftPM](spm.md), quindi se avete già familiarità con SwiftPM vi sentirete a casa.
+Dopo aver creato, compilato ed eseguito la tua prima applicazione, è il momento di dare un'occhiata a come Vapor struttura le cartelle del progetto. La struttura si basa su [SwiftPM](spm.md), quindi se hai già familiarità con SwiftPM ti sentirai a casa.
 
 ```
 .
@@ -19,13 +19,13 @@ Dopo aver creato, compilato ed eseguito la vostra prima applicazione, è il mome
 └── Package.swift
 ```
 
-Le seguenti sezioni spiegano in maggior dettaglio la struttura della cartella.
+Le seguenti sezioni spiegano in maggior dettaglio la struttura delle cartelle.
 
 ## Public
 
-Questa cartella contiene tutti i file pubblici che saranno messi a disposizione dall'applicazione se `FileMiddleware` è abilitato. In genere si tratta di immagini, fogli di stile e script del browser. Ad esempio, una richiesta a `localhost:8080/favicon.ico` controlla se `Public/favicon.ico` esiste e lo restituisce.
+Questa cartella contiene tutti i file pubblici che saranno messi a disposizione dall'applicazione se `FileMiddleware` è abilitato. In genere si tratta di immagini, style sheet e script del browser. Ad esempio, una richiesta a `localhost:8080/favicon.ico` controlla se `Public/favicon.ico` esiste e lo restituisce.
 
-Perché Vapor possa servire i file pubblici, bisognerà abilitare `FileMiddleware` nel file `configure.swift`.
+Affinché Vapor possa servire i file pubblici, bisognerà abilitare `FileMiddleware` nel file `configure.swift`.
 
 ```swift
 // Fornisce i file dalla cartella `Public/`
@@ -38,7 +38,7 @@ app.middleware.use(fileMiddleware)
 ## Sources
 
 Questa cartella contiene tutti i file sorgente Swift che verranno utilizzati dal progetto.
-La cartella di primo livello, `App`, riflette il modulo del vostro pacchetto, come dichiarato nel manifesto [SwiftPM](spm.md).
+La cartella di primo livello, `App`, riflette il modulo del tuo pacchetto, come dichiarato nel manifesto [SwiftPM](spm.md).
 
 ### App
 
@@ -66,15 +66,15 @@ Questo file contiene la funzione `main(_:)`. Questo metodo viene chiamato dal si
 
 #### routes.swift
 
-Questo file contiene la funzione `routes(_:)`. Questo metodo viene chiamato da `configure(_:)` per registrare gli endpoints dell'applicazione.
+Questo file contiene la funzione `routes(_:)`. Questo metodo viene chiamato da `configure(_:)` per registrare gli endpoint dell'applicazione.
 
 ## Tests
 
-Per ogni mdulo non eseguibile nella cartella `Sources` si può avere una cartella corrispondente in `Tests`. Essa conterrà i test per quel modulo scritti sulla base del modulo di testing `XCTest`. I test possono essere eseguiti utilizzando `swift test` da riga di comando o premendo ⌘+U in Xcode.
+Per ogni modulo non eseguibile nella cartella `Sources` si può avere una cartella corrispondente in `Tests`. Essa conterrà i test per quel modulo scritti sulla base del modulo di testing `XCTest`. I test possono essere eseguiti utilizzando `swift test` da riga di comando o premendo ⌘+U in Xcode.
 
 ### AppTests
 
-Questa cartella contiene gli unit tests per il codice del modulo `App`.
+Questa cartella contiene gli unit test per il codice del modulo `App`.
 
 ## Package.swift
 

docs/getting-started/hello-world.it.md

@@ -1,15 +1,15 @@
 # Ciao, mondo
 
-Questa guida vi mostrerà, passo dopo passo, come creare, compilare ed eseguire il vostro primo progetto con Vapor.
+Questa guida ti mostrerà, passo dopo passo, come creare, compilare ed eseguire il tuo primo progetto con Vapor.
 
-Se non avete ancora installato Swift o la Toolbox Vapor, seguite la guida di installazione prima di continuare.
+Se non hai ancora installato Swift o la Toolbox Vapor, segui la guida di installazione prima di continuare.
 
 - [Installazione → macOS](../install/macos.md)
 - [Installazione → Linux](../install/linux.md)
 
 ## Nuovo Progetto
 
-Il primo passo è creare un nuovo progetto Vapor sul vostro computer. Aprite il terminale e utilizzate il comando `new` della Toolbox. Questo creerà una nuova cartella nella directory corrente contenente il progetto.
+Il primo passo è creare un nuovo progetto Vapor sul tuo computer. Apri il terminale e utilizza il comando `new` della Toolbox. Questo creerà una nuova cartella nella directory corrente contenente il progetto.
 
 ```sh
 vapor new hello -n
@@ -20,10 +20,10 @@ vapor new hello -n
 
 !!! tip
     Vapor e il template ora utilizzano `async`/`await` di default.
-    Se non potete aggiornare a macOS 12 e/o avete bisogno di continuare ad utilizzare gli `EventLoopFuture`s, 
-    utilizzate l'opzione `--branch macos10-15`.
+    Se non puoi aggiornare a macOS 12 e/o hai bisogno di continuare ad utilizzare gli `EventLoopFuture`, 
+    utilizza l'opzione `--branch macos10-15`.
 
-Una volta terminato il comando, entrate nella cartella appena creata:
+Una volta terminato il comando, entra nella cartella appena creata:
 
 ```sh
 cd hello
@@ -33,46 +33,46 @@ cd hello
 
 ### Xcode
 
-Per prima cosa, aprite il progetto in Xcode:
+Per prima cosa, apri il progetto in Xcode:
 
 ```sh
 open Package.swift
 ```
 
-Xcode inizierà automaticamente a scaricare le dipendenze di Swift Package Manager. La prima volta che aprite un progetto ci vorrà un po' di tempo. Quando la risoluzione delle dipendenze sarà completata, Xcode popolerà gli schemi disponibili.
+Xcode inizierà automaticamente a scaricare le dipendenze di Swift Package Manager. La prima volta che apri un progetto ci vorrà un po' di tempo. Quando la risoluzione delle dipendenze sarà completata, Xcode popolerà gli schemi disponibili.
 
-Nella parte superiore della finestra, alla destra dei pulsanti Play e Stop, cliccate sul nome del progetto per selezionare lo schema del progetto e selezionate un target di esecuzione appropriato, spesso "My Mac". Cliccate sul pulsante play per compilare ed eseguire il progetto.
+Nella parte superiore della finestra, alla destra dei pulsanti Play e Stop, clicca sul nome del progetto per selezionare lo schema del progetto e seleziona un target di esecuzione appropriato, spesso "My Mac". Clicca sul pulsante play per compilare ed eseguire il progetto.
 
-Dovreste ora veder apparire la Console nella parte inferiore della finestra di Xcode.
+Dovresti ora veder apparire la Console nella parte inferiore della finestra di Xcode.
 
 ```sh
 [ INFO ] Server starting on http://
 ```
 
 ### Linux
 
-Su Linux e altri sistemi operativi (e anche su macOS se non volete utilizzare Xcode) potete modificare il progetto nel vostro editor preferito, come Vim o VSCode. Per maggiori dettagli su come configurare altri IDE, consultate le [Guide di Swift sul Server](https://github.com/swift-server/guides/blob/main/docs/setup-and-ide-alternatives.md)
+Su Linux e altri sistemi operativi (e anche su macOS se non volete utilizzare Xcode) puoi modificare il progetto nel tuo editor preferito, come Vim o VSCode. Per maggiori dettagli su come configurare altri IDE, consulta le [Guide di Swift sul Server](https://github.com/swift-server/guides/blob/main/docs/setup-and-ide-alternatives.md)
 
-Per compilare ed eseguire il progetto, nel Terminale eseguite:
+Per compilare ed eseguire il progetto, nel Terminale esegui:
 
 ```sh
 swift run
 ```
 
-Questo comando compilerà ed eseguirà il progetto. La prima volta che lo eseguite ci vorrà un po' di tempo per scaricare e indicizzare le dipendenze. Una volta avviato, dovrebbe apparire il seguente codice nel terminale:
+Questo comando compilerà ed eseguirà il progetto. La prima volta che lo esegui ci vorrà un po' di tempo per scaricare e indicizzare le dipendenze. Una volta avviato, dovrebbe apparire il seguente codice nel terminale:
 
 ```sh
 [ INFO ] Server starting on http://127.0.0.1:8080
 ```
 
 ## Visitare Localhost
 
-Ora che il progetto è in esecuzione, aprite il vostro browser e visitate <a href="http://localhost:8080/hello" target="_blank">localhost:8080/hello</a> oppure <a href="http://127.0.0.1:8080" target="_blank">http://127.0.0.1:8080</a>. 
+Ora che il progetto è in esecuzione, apri il tuo browser e visita <a href="http://localhost:8080/hello" target="_blank">localhost:8080/hello</a> oppure <a href="http://127.0.0.1:8080" target="_blank">http://127.0.0.1:8080</a>. 
 
 Dovrebbe apparire la seguente pagina:
 
 ```html
 Hello, world!
 ```
 
-Congratulazioni per aver creato, compilato ed eseguito il vostro primo progetto Vapor! 🎉
+Congratulazioni per aver creato, compilato ed eseguito il tuo primo progetto Vapor! 🎉

docs/getting-started/spm.it.md

@@ -1,12 +1,12 @@
 # Swift Package Manager
 
-Il [Swift Package Manager](https://swift.org/package-manager/) (SPM) è utilizzato per la compilazione del codice sorgente e delle dipendenze del vostro progetto. Poiché Vapor si basa molto su SPM, è una buona idea capire i suoi funzionamenti di base.
+Il [Swift Package Manager](https://swift.org/package-manager/) (SPM) è utilizzato per la compilazione del codice sorgente e delle dipendenze del tuo progetto. Poiché Vapor si basa molto su SPM, è una buona idea capire i suoi funzionamenti di base.
 
 SPM è simile a Cocoapods, Ruby gems e NPM. Si può utilizzare SPM dalla riga di comando con comandi come `swift build` e `swift test` o con IDE compatibili. Tuttavia, a differenza di alcuni altri package manager, non esiste un indice centrale dei pacchetti SPM. Esso sfrutta invece gli URL delle repository Git e le dipendenze delle versioni utilizzando i [tag Git](https://git-scm.com/book/en/v2/Git-Basics-Tagging).
 
 ## Manifesto del Pacchetto
 
-Il primo posto in cui SPM cerca nel vostro progetto è il manifesto del pacchetto. Questo dovrebbe sempre essere situato nella directory principale del vostro progetto e chiamarsi `Package.swift`.
+Il primo posto che SPM cerca nel tuo progetto è il manifesto del pacchetto. Questo dovrebbe sempre essere situato nella directory principale del tuo progetto e chiamarsi `Package.swift`.
 
 Diamo un'occhiata a questo esempio di manifesto del pacchetto.
 
@@ -60,18 +60,18 @@ Nell'esempio precedente, si può notare che il pacchetto dipende da [vapor/vapor
 
 ### Target
 
-I target sono i moduli che compongono il vostro pacchetto. I target possono essere eseguibili, librerie o test. Solitamente un progetto Vapor ha due target, tuttavia se ne possono aggiungere in modo da organizzare il codice.
+I target sono i moduli che compongono il tuo pacchetto. I target possono essere eseguibili, librerie o test. Solitamente un progetto Vapor ha due target, tuttavia se ne possono aggiungere in modo da organizzare il codice.
 Ogni target dichiara i moduli da cui dipende. Per poter importare ed usare i vari moduli nel codice bisogna dichiarare qui i loro nomi. Un target può dipendere da altri target nello stesso pacchetto o da qualsiasi modulo presente nei pacchetti aggiunto all'array delle [dipendenze principali](#dependencies).
 
-## Struttura della Cartella
+## Struttura delle Cartelle
 
-Questa è la tipica struttura di una cartella di un pacchetto SPM:
+Questa è la tipica struttura delle cartelle di un pacchetto SPM:
 
 ```
 .
 ├── Sources
 │   └── App
-│       └── (Source code)
+│       └── (Codice sorgente)
 ├── Tests
 │   └── AppTests
 └── Package.swift
@@ -88,7 +88,7 @@ Per aggiornare le dipendenze basta eseguire `swift package update` e SPM aggiorn
 
 # Xcode
 
-Usando Xcode qualsiasi cambiamento a dipendenze, target, prodotti ecc. sarà automatico non appena si salva il file `Package.swift`.
+Usando Xcode qualsiasi cambiamento a dipendenze, target, prodotti, ecc. sarà automatico non appena si salva il file `Package.swift`.
 
 Per aggiornare le dipendenze, basta andare su File → Swift Packages → Update to Latest Package Versions.
 

docs/getting-started/xcode.it.md

@@ -1,12 +1,12 @@
 # Xcode
 
-Questa pagina contiene alcuni consigli e trucchi per l'utilizzo di Xcode. Non è necessaria se si preferisce usare un ambiente di sviluppo diverso.
+Questa pagina contiene alcuni consigli e trucchi per l'utilizzo di Xcode. Puoi saltarla se preferisci usare un ambiente di sviluppo diverso.
 
 ## Directory di lavoro personalizzata
 
 Di default Xcode eseguirà il progetto dalla cartella _DerivedData_. Questa cartella non è la stessa della cartella principale del progetto (dove si trova il file _Package.swift_). Questo significa che Vapor non sarà in grado di trovare file e cartelle come _.env_ o _Public_.
 
-Si può notare che questo sta accadendo se si vede il seguente avviso quando si esegue il progetto.
+Si capisce se questo sta accadendo se si vede il seguente avviso quando si esegue il progetto.
 
 ```fish
 [ WARNING ] No custom working directory set for this scheme, using /path/to/DerivedData/project-abcdef/Build/
@@ -40,5 +40,5 @@ Si dovrebbe vedere un output simile al seguente.
 ```
 framework: 4.x.x
 toolbox: 18.x.x
-/path/to/project
+/percorso/al/progetto
 ```