Benvenuti a tutti i nuovi contributors! 👋

In questa repository viene pubblicata la traduzione italiana del tutorial 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.

Prima di iniziare ti segnalo che esiste anche un Canale Discord 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 reperibili 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!

• Note importanti
• Come contribuire
• Consigli per la traduzione

• 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. Il tutorial è in costante aggiornamento, quindi gli articoli presenti in questo repository potrebbero non essere aggiornati all'ultima versione.

Ti chiedo di leggere rapidamente anche il documento CONTRIBUTING.MD, in cui potrai trovare tutte le informazioni sul modo migliore per collaborare al respository!

Durante la traduzione tenete sempre sotto mano il Glossario. 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

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.

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!

No, l'articolo va tradotto nella sua interezza.

♥
Ilya Kantor @iliakan