# The Modern JavaScript Tutorial in italiano

Benvenuti a tutti i nuovi contributors! 👋

In questa repository viene pubblicata la traduzione italiana del tutorial [javascript.info](https://javascript.info).

Ci piacerebbe ricevere il tuo contributo nella traduzione e/o revisione degli articoli. 

Se hai idee da proporre o suggerimenti, allora fai riferimento al [repository inglese](https://github.com/javascript-tutorial/en.javascript.info).

Prima di iniziare ti segnalo che esiste anche un **[Canale Discord](https://discord.gg/Dj9P3jCt6K)** in cui potrai parlare con gli altri contributors di quello che riguarda la traduzione e revisione degli articoli. O anche ricevere delle indicazioni su come iniziare! Non è assolutamente obbligatorio accedere al server per lavorare alle traduzioni, le informazioni necessarie sono tutte repereibili in questo repository.

Se hai deciso di contribuire innanzitutto ti ringrazio per il supporto, e ti chiedo di leggere fino alla fine questo documento, in modo da velocizzare le revisioni e ridurre gli errori, ci vorranno meno di 5 minuti!

## Indice
  - [Note importanti](#importante)
  - [Come contribuire](#come-contribuire)
  - [Consigli per la traduzione](#consigli-per-la-traduzione)

## Importante

- Quando effettui le traduzioni lavora **sempre** in un branch dedicato, in questo modo manteniamo il branch `master` il più pulito possibile. Continua a leggere per maggiori informazioni.

- Quando effettui le traduzioni fai sempre riferimento al [repository inglese](https://github.com/javascript-tutorial/en.javascript.info). Il tutorial è in costante aggiornamento, quindi gli articoli presenti in questo repository potrebbero non essere aggiornati all'ultima versione.

## Come contribuire

Ti chiedo di leggere rapidamente anche il documento [CONTRIBUTING.MD](https://github.com/javascript-tutorial/it.javascript.info/blob/master/CONTRIBUTING.md), in cui potrai trovare tutte le informazioni sul modo migliore per collaborare al respository!

## Consigli per la traduzione

Durante la traduzione tenete sempre sotto mano il [Glossario](https://github.com/javascript-tutorial/it.javascript.info/issues/167).
Questo vi sarà utile in fase di traduzione nel caso in cu incontraste una parola che non sapete se o come tradurre. Esempio il termine `debugger` viene mantenuto tale anche in italiano, in quanto di uso comune nell'ambito dello sviluppo software. Nel caso in cui la parola non sia presente nel glossario, potete richiedere consiglio lasciando un commento.

Altre cose utili da tenere a mente in fase di traduzione:
  - Tradurre l'articolo nella sua interezza, compresi i task e le solutions
  - Tradurre anche i commenti negli esempi all'interno degli articoli

Cosa **non** tradurre:
  - Non è necessario tradurre il codice degli esempi, è sufficiente la traduzione dei commenti. Quindi il contenuto degli alert, console.log, nomi delle funzioni/classi deve rimanere in lingua inglese.

  ```
    function sayHello() {
      alert("Hello, World!") // show the text 'Hello, World!'
    }
  ```

  verrà tradotto come segue:

  ```
    function sayHello() {
      alert("Hello, World!") // mostra il testo 'Hello, World!'
    }
  ```

  - Non è necessario tradurre le immagini utilizzate durante le spiegazioni
  
  - All'interno dei files degli esercizi `task.md` la voce iniziale `importance:` non va tradotta

### FAQ

  <details>
    <summary>In quale formato sono scritti gli articoli?</summary>

    Il tutorial segue lo standard testuale "Markdown", è molto semplice da utilizzare. In ogni caso non vi è richiesto di mettere mano al formato, è sufficiente la traduzione del testo.
  </details>

  <details>
    <summary>Cosa posso utilizzare per tradurre gli articoli?</summary>

    Puoi tradurre gli articoli utilizzando il tool con cui ti trovi più comodo. Puoi farlo direttamente con l'editor di testo integrato di GitHub se ti trovi più a tuo agio.

    L'importante è rispettare le linee guida fornite sopra!
  </details>

  <details>
    <summary>Posso tradurre un solo paragrafo?</summary>

    No, l'articolo va tradotto nella sua interezza.
  </details>

---
# Grazie per la collaborazione 😍

---  
♥  
Ilya Kantor @iliakan