Merge pull request #144 from longo-andrea/feature/variables

Review ' Variables' article

Author: longo-andrea

1-js/02-first-steps/04-variables/2-declare-variables/solution.md

@@ -8,7 +8,11 @@ let ourPlanetName = "Earth";
 
 Nota che avremmo anche potuto usare un nome più corto, come `planet`, ma potrebbe non essere ovvio a cosa si rifrisce. E' una buona cosa essere un pò più descrittivi. Almeno finche le variabili nonDiventanoTroppoLunghe.
 
+# Il nome del visitatore attuale
+
+```js
 let currentUserName = "John";
+```
 
 Di nuovo, potremmo accorciare il nome con `userName`, se fossimo sicuri che quell'utente sia quello corrente.
 

1-js/02-first-steps/04-variables/article.md

@@ -1,24 +1,24 @@
 # Variabili
 
-La maggior parte delle volte, le applicazioni JavaScript necessitano d'informazione per poter lavorare. Vediamo due esempi:
+La maggior parte delle volte, le applicazioni JavaScript necessitano di lavorare con informazioni. Vediamo due esempi:
 1. Un negozio online -- le informazioni possono riguardare i beni venduti e il carrello.
 2. Un applicazione di messaggistica -- le informazioni possono riguardare utenti, messaggi e molto altro.
 
 Le variabili vengono utilizzate per memorizzare informazioni.
 
 ## Variabile
 
-Una variabile [variable](https://en.wikipedia.org/wiki/Variable_(computer_science)) è un "memorizzatore con nome" per i dati. Possiamo usare le variabile per memorizzare informazioni extra, visitatori e altri dati.
+Una [variabile](https://en.wikipedia.org/wiki/Variable_(computer_science)) è uno "spazio di memoria con nome" utilizzato per salvare dati. Possiamo usare le variabili per memorizzare informazioni extra, visitatori e altri dati.
 
 Per creare una variabile in JavaScript, dobbiamo utilizzare la parola chiave `let`.
 
-L'istruzione sotto crea(in altre parole: *dichiara* o *definisce*) una variabile identificata dal nome "messaggio":
+L'istruzione sotto crea (in altre parole: *dichiara*) una variabile identificata dal nome "messaggio":
 
 ```js
 let message;
 ```
 
-Adesso possiamo inserirci dati utilizzando l'operatore di assegnazione `=`:
+Adesso possiamo inserirci dei dati utilizzando l'operatore di assegnazione `=`:
 
 ```js
 let message;
@@ -53,7 +53,7 @@ Possiamo anche dichiarare più variabili in una riga:
 let user = 'John', age = 25, message = 'Hello';
 ```
 
-Questo potrebbe risultare più breve, ma è sconsigliato. Per mantenere una migliore leggibilità è meglio utilizzare una riga per ogni variabile.
+Questo potrebbe risultare più breve, ma è sconsigliato. Per mantenere una migliore leggibilità è meglio dichiarare solamente una variabile per riga.
 
 L'alternativa a più righe è un po più lunga, ma più facile da leggere:
 
@@ -70,7 +70,7 @@ let user = 'John',
   message = 'Hello';
 ```
 
-...O anche con la virgola nella nuova riga:
+...O anche con la virgola su nuova riga:
 
 ```js no-beautify
 let user = 'John'
@@ -92,9 +92,9 @@ La parola chiave `var` è *quasi* la stessa cosa di `let`. Dichiara comunque una
 Ci sono delle sottili differenze tra `let` e `var`, ma per ora non hanno importanza. Le copriremo in dettaglio più avanti, nel capitolo <info:var>.
 ````
 
-## Un analogia con il mondo reale
+## Un'analogia con il mondo reale
 
-Possiamo comprendere meglio il concetto di "variabile" se la immaginiamo come una scatola per i dati, con appiccicata un etichetta univoca.
+Possiamo comprendere meglio il concetto di "variabile" se la immaginiamo come una scatola per dati, con appiccicata un'etichetta univoca.
 
 Per esempio, la variabile `message` può essere immaginata come una scatola con etichetta `"message"` con il valore `"Hello!"` al suo interno:
 
@@ -134,12 +134,26 @@ alert(hello); // Hello world!
 alert(message); // Hello world!
 ```
 
+````warn header="Dichiarare una variabile più di una volta farà scattare un errore"
+Una variabile dovrebbe essere dichiarata una volta sola.
+
+La ripetizioni della dichiarazione di una stessa variabile porterà ad un errore:
+
+```js run
+let message = "This";
+
+// 'let' ripetuto genererà un errore
+let message = "That"; // SyntaxError: 'message' has already been declared
+```
+Quindi, dovremmo dichiarare una variabile una volta sola, e farne riferimento senza la parola chiave `let`.
+````
+
 ```smart header="Linguaggi funzionali"
 Può essere interessante sapere che esistono anche linguaggi di programmazione [funzionale](https://en.wikipedia.org/wiki/Functional_programming) che vietano di cambiare il valore di una variabile. Per esempio, [Scala](http://www.scala-lang.org/) o [Erlang](http://www.erlang.org/).
 
 In questo tipo di linguaggi, una volta che il valore viene memorizzato "dentro la scatola", ci rimane per sempre. Se abbiamo bisogno di memorizzare qualcos altro, il linguaggio ci forza a creare una nuova scatola (dichiarare una nuova variabile). Non possiamo quindi riutilizzare quelle vecchie.
 
-Anche se potrebbero sembrare un pò strano a prima vista, questi linguaggi sono veramente capaci di sviluppare grandi cose. Inoltre, ci sono certe situazioni come calcoli paralleli in cui questi limiti portano dei benefici. Studiare un linguaggio di questo tipo (anche se non abbiamo intenzione di utilizzarlo a breve) è consigliato per allargare le proprie conoscenze.
+Anche se potrebbero sembrare un po' strano a prima vista, questi linguaggi sono veramente capaci di sviluppare grandi cose. Inoltre, ci sono certe situazioni come calcoli paralleli in cui questi limiti portano dei benefici. Studiare un linguaggio di questo tipo (anche se non abbiamo intenzione di utilizzarlo a breve) è consigliato per allargare le proprie conoscenze.
 ```
 
 ## Nomi delle variabili [#variable-naming]
@@ -189,11 +203,11 @@ let имя = '...';
 let 我 = '...';
 ```
 
-Tecnicamente, non ci sono errori, questo tipo di nomi sono permessi, ma la tradizione internazionale è di utilizzare l'alfabeto inglese per il nome delle variabili. Anche se stiamo scrivendo un piccolo script, potrebbe infatti avere una lunga vita. Persone di altre nazionalità potrebbero aver bisogno di leggerlo.
+Tecnicamente, non ci sono errori, questo tipo di nomi sono permessi, ma la tradizione internazionale è di utilizzare l'alfabeto inglese per il nome delle variabili. Anche se stiamo scrivendo un piccolo script, questo potrebbe infatti avere una lunga vita. Persone di altre nazionalità potrebbero aver bisogno di leggerlo.
 ````
 
 ````warn header="Nomi riservati"
-C'e una [lista di parole riservate](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#Keywords), che non possono essere utilizzare come nomi di variabili, perchè vengono utilizzate dal linguaggio stesso.
+C'e una [lista di parole riservate](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Lexical_grammar#Keywords), che non possono essere utilizzare come nomi di variabili, perché vengono utilizzate dal linguaggio stesso.
 
 Per esempio, le parole `let`, `class`, `return`, `function` sono riservate.
 
@@ -228,7 +242,7 @@ num = 5; // errore: num non è definita
 ```
 ````
 
-## Constanti
+## Costanti
 
 Per dichiarare una variabile costante (immutabile), dobbiamo utilizzare `const` invece di `let`:
 
@@ -243,7 +257,9 @@ const myBirthday = '18.04.1982';
 
 myBirthday = '01.01.2001'; // errore, non è possibile riassegnare la costante!
 ```
-Quando il programmatore è sicuro che il valore della variabile non cambierà mai, può utilizzare `const` per soddisfare questa esigenza, e metterlo anche in mostra a tutti gli altri.
+
+Quando il programmatore è sicuro che il valore della variabile non cambierà mai, può utilizzare `const` per soddisfare questa esigenza, rendendolo cosi esplicito.
+
 
 ### Le costanti maiuscole
 
@@ -272,24 +288,25 @@ Benefici:
 
 Quando dovremmo utilizzare lettere maiuscole per una costante, e quando invece trattarle come normali variabili? Facciamo un pò di chiarezza.
 
-Essere una "costante" significa che il valore non potrà mai cambiare. Ci sono costanti che sono note prima dell'esecuzione (come la codifia esadecimale del colore rosso), e ci sono quelle che vengono *calcolate* durante l'esecuzione, ma non cambieranno più dopo che gli sarà stato assegnato un valore.
+Essere una "costante" significa che il valore non potrà mai cambiare. Ci sono costanti che sono note prima dell'esecuzione (come la codifica esadecimale del colore rosso), e ci sono quelle che vengono *calcolate* durante l'esecuzione, ma non cambieranno più dopo che gli sarà stato assegnato un valore.
 
 Per esempio:
 ```js
 const pageLoadTime = /* tempo necessario da una pagina web per caricare */;
 ```
-Il valore di `pageLoadTime` non è noto prima del caricamento della pagina, quindi viene trattato come una normale variabile. Ma rimane comunque una costante, perchè non potrà più cambiare dopo che gli sarà stato assegnato un valore.
+
+Il valore di `pageLoadTime` non è noto prima del caricamento della pagina, quindi viene trattato come una normale variabile. Ma rimane comunque una costante, perché non potrà più cambiare dopo che gli sarà stato assegnato un valore.
 
 In altre parole, i nomi delle costanti in maiuscolo vengono utilizzati con variabili dal valore noto prima dell'esecuzione.
 
 ## Dare i giusti nomi alle cose
 
 Parlando di variabili, c'è un'altra cosa estremamente importante.
 
-Per favore, utilizzate i nomi delle variabili con sensibilità. Prendetevi del tempo per pensare se necessario.
+Il nome di una variabile dovrebbe sempre essere pulito, ovvio e descrittivo del suo contenuto.
 
 Dare i giusti nomi alle variabili è una delle abilità più importanti (e difficili) nella programmazione. 
-Una rapida occhiata ai nomi delle variabili può rivelare se il codice è stato scritto da un beginner o da uno sviluppatore esperto.
+Una rapida occhiata ai nomi delle variabili può rivelare se il codice è stato scritto da un principiante o da uno sviluppatore esperto.
 
 In un progetto reale, la maggior parte del tempo lo si perde a modificare ed estendere del codice già esistente, piuttosto che riscriverne uno nuovo. E quando ritorneremo sul codice, dopo aver fatto qualcos'altro, sarà molto pù facile trovare informazioni se sono ben descritte. In altre parole, quando le variabili utilizzano dei nomi efficaci.
 
@@ -311,7 +328,7 @@ Il risultato che si ottiene, è che le variabili sono come delle scatole in cui
 
 Questo genere di programmatori risparmiano qualche bit nella dichiarazione delle variabili ma perdono dieci volte il tempo risparmiato per fare debugging del codice.
 
-Una variable in più va bene, non sono il diavolo.
+Una variabile in più non è necessariamente un male.
 
 I browser moderni e JavaScript minimizzano ed ottimizzano il codice abbastanza bene, quindi non ci saranno problemi di performance. Usare variabili differenti, per valori differenti può addirittura aiutare il motore JavaScript nell'ottimizzazione.
 ```