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 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!
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:
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
♥
Ilya Kantor @iliakan