Merge branch 'main' of https://github.com/DeltaPy/TypeScript-Website-Localizations into main

Author: DeltaPy

.github/CODEOWNER renamed to .github/CODEOWNERS

@@ -1,11 +1,11 @@
 # See https://github.com/OSS-Docs-Tools/code-owner-self-merge#readme
 
 # Collaborators for Japanese Translation of the Website
-docs/playground/ja @sasurau4 @Quramy @Naturalclar @Takepepe [translation] [jp]
-docs/tsconfig/ja/**/*.md @sasurau4 @Quramy @Naturalclar @Takepepe [translation] [jp]
-docs/typescriptlang/ja/**/*.ts @sasurau4 @Quramy @Naturalclar @Takepepe [translation] [jp]
-docs/typescriptlang/ja.ts @sasurau4 @Quramy @Naturalclar @Takepepe [translation] [jp]
-docs/documentation/ja/**/*.md @sasurau4 @Quramy @Naturalclar @Takepepe [translation] [jp]
+docs/playground/ja @sasurau4 @Quramy @Naturalclar [translation] [jp]
+docs/tsconfig/ja/**/*.md @sasurau4 @Quramy @Naturalclar [translation] [jp]
+docs/typescriptlang/ja/**/*.ts @sasurau4 @Quramy @Naturalclar [translation] [jp]
+docs/typescriptlang/ja.ts @sasurau4 @Quramy @Naturalclar [translation] [jp]
+docs/documentation/ja/**/*.md @sasurau4 @Quramy @Naturalclar [translation] [jp]
 
 # Collaborators for Portuguese Translation of the Website
 docs/playground/pt @khaosdoctor @danilofuchs [translation] [pt]
@@ -29,11 +29,11 @@ docs/typescriptlang/zh.ts @Kingwl [translation] [zh]
 docs/documentation/zh/**/*.md @Kingwl [translation] [zh]
 
 # Collaborators for Korean Translation of the Website
-docs/playground/ko @Bumkeyy [translation] [ko]
-docs/tsconfig/ko/**/*.md @Bumkeyy [translation] [ko]
-docs/typescriptlang/ko/**/*.ts @Bumkeyy [translation] [ko]
-docs/typescriptlang/ko.ts @Bumkeyy [translation] [ko]
-docs/documentation/ko/**/*.md @Bumkeyy [translation] [ko]
+docs/playground/ko @Bumkeyy @yeonjuan @guyeol [translation] [ko]
+docs/tsconfig/ko/**/*.md @Bumkeyy @yeonjuan @guyeol [translation] [ko]
+docs/typescriptlang/ko/**/*.ts @Bumkeyy @yeonjuan @guyeol [translation] [ko]
+docs/typescriptlang/ko.ts @Bumkeyy @yeonjuan @guyeol [translation] [ko]
+docs/documentation/ko/**/*.md @Bumkeyy @yeonjuan @guyeol [translation] [ko]
 
 # Collaborators for Indonesian Translation of the Website
 docs/playground/id @jefrydco @nusendra @mazipan @mandaputtra [translation] [id]
@@ -57,8 +57,8 @@ docs/typescriptlang/pl.ts @msieroslawska @TomWebwalker [translation] [pl]
 docs/documentation/pl/**/*.md @msieroslawska @TomWebwalker [translation] [pl]
 
 # Collaborators for Italian Translation of the Website
-docs/playground/it @Nabster101 @BassDrop07 @PyGera [translation] [it]
-docs/tsconfig/it/**/*.md @Nabster101 @BassDrop07 @PyGera [translation] [it]
-docs/typescriptlang/it/**/*.ts @Nabster101 @BassDrop07 @PyGera [translation] [it]
-docs/typescriptlang/it.ts @Nabster101 @BassDrop07 @PyGera [translation] [it]
-docs/documentation/it/**/*.md @Nabster101 @BassDrop07 @PyGera [translation] [it]
+docs/playground/it @Nabster101 @DeltaPy @PyGera  [translation] [it]
+docs/tsconfig/it/**/*.md @Nabster101 @DeltaPy @PyGera  [translation] [it]
+docs/typescriptlang/it/**/*.ts @Nabster101 @DeltaPy @PyGera  [translation] [it]
+docs/typescriptlang/it.ts @Nabster101 @DeltaPy @PyGera  [translation] [it]
+docs/documentation/it/**/*.md @Nabster101 @DeltaPy @PyGera  [translation] [it]

.github/workflows/codeowners-merge.yml

@@ -1,6 +1,6 @@
 name: Codeowners merging
 on:
-  pull_request_target: { types: opened }
+  pull_request_target: { types: [ opened, synchronize, reopened] }
   issue_comment: { types: created }
   pull_request_review: { types: submitted }
 

README.md

@@ -15,7 +15,9 @@ yarn
 yarn pull-en
 
 # Optional: Verify your changes will correctly replace the english files
-yarn validate-paths
+yarn lint
+# Alternative: Run the lint watcher
+yarn lint --watch
 ```
 
 That's it, you've got a copy of all the documentation and now can write documentation which follows the existing patterns.
@@ -46,7 +48,8 @@ For example if you wanted to translate a new handbook page you would:
 - Pull in the English files `yarn pull-en` (these will be gitignored)
 - Find your english file: `docs/documentation/en/handbook-v2/Basics.md`
 - Recreate the same folder path in your language: `docs/documentation/it/handbook-v2/Basics.md`
-- Translate the file! 
+- Translate the file!
+- Validate your changes: `yarn lint` (or `yarn lint docs/documentation/it/handbook-v2/Basics.md`)
 - Create a pull request to this repo
 - Once merged, the translation will appear on the next website deploy
 
@@ -56,12 +59,14 @@ When a new language is created, we ask for a few people to become language owner
 
 The TypeScript team generally only know English, and can answer clarifying questions if needed! For quick questions, you can use the `ts-website-translation` channel in the [TypeScript Discord](https://discord.gg/typescript).
 
-#### Well tested
+#### Secure
 
 This repo has extensive CI to ensure that you can't accidentally break the TypeScript website. 
 
 There are local, fast checks that it won't break via `yarn test` and then the full TypeScript website test suite runs with the changes, and a website build is generated to ensure that nothing breaks.
 
+The checks may not seem obvious to an outsider, because the website is complex, so there is a watch mode which you can run via `yarn link --watch` to get instant feedback.
+
 # Contributing
 
 This project welcomes contributions and suggestions.  Most contributions require you to agree to a

docs/tsconfig/it/options/downlevelIteration.md

@@ -0,0 +1,91 @@
+---
+display: "Iterazione di livello inferiore"
+oneline: "Emette Javascript compatibile e più dettagliato per oggetti iterativi"
+---
+
+Iterazione di livello inferiore, o Downleveling, è un termine di TypeScript utilizzato per migrare verso una versione precedente di JavaScript. Questa flag permette quindi di supportare una più accurata implementazione di come il JavaScript moderno itera i nuovi concetti in versioni precedenti di JavaScript in runtime.   
+
+ECMAScript 6 aggiunge una serie di nuove iterazioni primitive: il `for / of` loop (`for (el of arr)`), spread di Array (`[a, ...b]`), spread di argomenti (`fn (... args)`) e [`Symbol.iterator`](https://medium.com/trainingcenter/iterators-em-javascript-880adef14495).`--downlevelIteration` permette a queste iterazioni primitive di essere utilizzate in modo più accurrato in un ambiente ES5 se un'implementazione di [`Symbol.iterator`](https://medium.com/trainingcenter/iterators-em-javascript-880adef14495) è presente.
+
+#### Esempio: Effetti su `for / of`    
+
+Con questo codice TypeScript:
+
+```js
+const str = "Ciao!";
+for (const s of str) {
+  console.log(s);
+}
+```
+
+Senza `downlevelIteration` attivo, un loop `for / of` su un qualsiasi oggetto viene convertito in un tradizionale `for` loop:
+
+```ts twoslash
+// @target: ES5
+// @showEmit
+const str = "Ciao!";
+for (const s of str) {
+  console.log(s);
+}
+```
+
+Generalmente tutti si aspettano questo, tuttavia non è compatibile al 100% con il protocollo di iterazione ECMAScript 6. Certe string, ad esempio un emoji (😜), hanno un `.length` di 2 (o anche di più!), ma dovrebbero iterare come 1 unità in un `for-of` loop. Guarda [questo blog post di Jonathan New](https://blog.jonnew.com/posts/poo-dot-length-equals-two) per una spiegazione più dettagliata.
+
+Quando `downlevelIteration` è attivo, TypeScript utilizzerà una funzione ausiliaria che andrà a controllare la presenza di un `Symbol.iterator` (che può essere di tipo nativo o polyfill). Nel caso in cui questa implementazione non ci sia, ritornerai ad un'iterazione index-based.  
+
+```ts twoslash
+// @target: ES5
+// @downlevelIteration
+// @showEmit
+const str = "Ciao!";
+for (const s of str) {
+  console.log(s);
+}
+```
+
+Puoi utilizzare [tslib](https://www.npmjs.com/package/tslib) via [importHelpers](#importHelpers) in modo da ridurre il numero di righe inline Javascript:
+
+```ts twoslash
+// @target: ES5
+// @downlevelIteration
+// @importHelpers
+// @showEmit
+const str = "Ciao!";
+for (const s of str) {
+  console.log(s);
+}
+```
+
+> > **Nota:** attivare `downlevelIteration` non andrà a migliorare le prestazioni di compliazione se `Symbol.iterator` non è presente in runtime.
+
+#### Esempio: Effetti sullo spray di Array
+
+Questo è un spread di array:
+
+```js
+// Crea un nuovo array composto dall'elemento 1 seguito dagli elementi di arr2
+const arr = [1, ...arr2];
+```
+
+Secondo la descrizione, sembra facile convertirlo in ES5:
+
+```js
+// Stessa cosa, no?
+const arr = [1].concat(arr2);
+```
+
+Tuttavia, questo è visibilmente diverso in certi rari casi. Ad esempio, nel caso un array abbia un "buco", l'index mancante andrà a creare una proprietà *own* nel caso si decida di applicare uno spread, ma non se creato utilizzando `.concat`:
+
+```js
+// Crea un array dove manca l'elemento '1'
+let mancante = [0, , 1];
+let spread = [...mancante];
+let concatenato = [].concat(mancante);
+
+// true
+"1" in spread;
+// false
+"1" in concatenato;
+```
+
+Proprio come un `for / of`, `downlevelIteration` andrà ad usare `Symbol.iterator` (se presente) in modo da emulare in modo più preciso il comportamento di ES 6.

docs/tsconfig/it/options/importHelpers.md

@@ -0,0 +1,44 @@
+---
+display: "Importazione di Aiuti"
+oneline: "Permette di importare alcune funzioni ausiliari per il progetto"
+
+---
+
+TypeScript da alcuni suggerimenti per operazioni di livello inferiore come ad esempio estendere classi, spread di array o oggetti, e operazioni asincrone. In modo predefinito, questi suggerimenti vengono dati nei file che usano le operazioni elencate in precedenza. Tuttavia, nel caso in cui lo stesso suggerimento è usato in più moduli diversi, si possono verificare alcuni casi di duplicazione del codice.
+
+Se l'opzione `importHelpers` è attiva, queste funzionalità ausiliari vengono importate dal modulo [tslib](https://www.npmjs.com/package/tslib). Dovrai assicurarti che il modulo `tslib` è in grado di essere importato in runtime. Questo riguarda solo i moduli; I file degli script globali non proveranno ad importare i moduli.
+
+Per esempio, con questo codice TypeScript:
+
+
+```ts
+export function fn(arr: number[]) {
+  const arr2 = [1, ...arr];
+}
+```
+
+Attivando [`downlevelIteration`](#downlevelIteration), esso rimane falso:
+
+```ts twoslash
+// @showEmit
+// @target: ES5
+// @downleveliteration
+export function fn(arr: number[]) {
+  const arr2 = [1, ...arr];
+}
+```
+
+Poi attivando entrambi [`downlevelIteration`](#downlevelIteration) e `importHelpers`:
+
+```ts twoslash
+// @showEmit
+// @target: ES5
+// @downleveliteration
+// @importhelpers
+// @noErrors
+export function fn(arr: number[]) {
+  const arr2 = [1, ...arr];
+}
+```
+
+Puoi utilizzare [`noEmitHelpers`](#noEmitHelpers) quando metti a disposizione la tua implementazione di queste funzioni.

docs/tsconfig/it/options/incremental.md

@@ -0,0 +1,9 @@
+---
+display: "Incrementale"
+oneline: "Crea dei file .tsbuildinfo per permettere la compilazione incrementale del progetto"
+---
+
+Dice a TypeScript di salvare le informazioni riguardo il grafo del progetto dall'ultima compliazione nei file salvati nel disco.
+Questo crea una serie di file `.tsbuildinfo` nella stessa cartella del risultato della compilazione. Essi non vengono usati dal tuo JavaScript durante l'esecuzione e possono essere tranquillamente eliminati. Puoi saperne di più riguardo questa flag nelle [3.4 note di rilascio](/docs/handbook/release-notes/typescript-3-4.html#faster-subsequent-builds-with-the---incremental-flag).
+
+Per scegliere in che cartella vuoi i tuoi file compilati, usa l'opzione di configurazione [`tsBuildInfoFile`](#tsBuildInfoFile).

docs/tsconfig/it/options/isolatedModules.md

@@ -0,0 +1,75 @@
+---
+display: "Moduli Isolati"
+oneline: "Si assicura che ogni file possa essere compilato in sicurezza senza basarsi sulle altre importazioni"
+---
+
+Quando usi TypeScript per produrre codice JavaScript, è usanza comune usare altri transpilers come ad esempio [Babel](https://babeljs.io).
+Tuttavia, gli altri transpilers possono operare solo su un singolo file alla volta, questo significa che non possono fare cambiamenti che dipendono dalla comprensione dell'intero progetto. 
+Questa regola si applica anche al `ts.transpileModule` API di TypeScript che è usata da alcuni strumenti di esecuzione.
+
+Queste limitazioni possono causare problemi di esecuzione con alcune funzionalità di TypeScript come `const enum` e `namespace`.
+Impostando la flag `isolatedModules` chiedi a TypeScript di avvisarti se stai scrivendo del codice che non può essere correttamente interpretato da un processo di transpilation su un singolo file.
+
+Esso non cambia la forma del tuo codice e nemmeno la forma del controllo di TypeScript e il processo di emissione.
+
+Alcuni esempi di codice che non funzionano quando `isolatedModules` è abilitato.
+
+#### Esportazione di idententificatori senza valore
+
+In TypeScript, puoi importare un _type_ e di conseguenza esportarlo:
+
+```ts twoslash
+// @noErrors
+import { tipo, funzione } from "modulo";
+
+funzione();
+
+export { tipo, funzione };
+```
+
+Dato che non ci sono valori per `tipo`, l'emissione `export` non proverà ad esportarlo (questo perché ci sarebbe un errore di esecuzione in JavaScript):
+
+```js
+export { funzione };
+```
+
+I transpilers a singolo file non sanno se `tipo` produce un valore o meno, quindi c'è un errore nell'esportazione di un nome che si riferisce solo ad un tipo.
+
+#### File Non-Moduli
+
+Se `isolatedModules` è impostato, tutti file di implementazione devono essere _modules_ (ciò significa che esso ha alcune forme di `import` / `export`). Un errore appare se nessun file è un modulo:
+
+```ts twoslash
+// @errors: 1208
+// @isolatedModules
+function fn() {}
+```
+
+Questa regola non viene applicata ai file `.d.ts`
+
+#### Riferimenti ai membri `const enum`
+
+In TypeScript, quando ti riferisci ad un membro `const enum`, il riferimento viene rimpiazzato dal suo valore attuale nel JavaScript compilato. Cambiando questo TypeScript:
+
+```ts twoslash
+declare const enum Numeri {
+  Zero = 0,
+  Uno = 1,
+}
+console.log(Numeri.Zero + Numeri.Uno);
+```
+
+Con questo JavaScript:
+
+```ts twoslash
+// @showEmit
+// @removeComments
+declare const enum Numeri {
+  Zero = 0,
+  Uno = 1,
+}
+console.log(Numeri.Zero + Numeri.Uno);
+```
+
+Senza la conoscenza del valore di questi membri, gli altri transpilers non possono rimpiazzare il riferimento a `Numeri`, questo comporterebbe un errore di esecuzione se lasciato a se stesso (dal momento in cui non ci sono oggetti di tipo `Numeri` in esecuzione).
+A causa di questo, quando `isolatedModules` è impostato, c'è un errore nel riferire un ambiente ad un membro `const enum`.