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
masteril 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.mdla voce inizialeimportance:non va tradotta
In quale formato sono scritti gli articoli?
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.
Cosa posso utilizzare per tradurre gli articoli?
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!
Posso tradurre un solo paragrafo?
No, l'articolo va tradotto nella sua interezza.
♥
Ilya Kantor @iliakan