javascript-tutorial · vplentinax · Sep 17, 2020 · May 21, 2020 · May 21, 2020 · May 23, 2020
diff --git a/.gitattributes b/.gitattributes
@@ -1 +1,2 @@
 * text=auto eol=lf
+*.svg       binary
diff --git a/1-js/01-getting-started/1-intro/article.md b/1-js/01-getting-started/1-intro/article.md
@@ -12,7 +12,7 @@ Los scripts se proporcionan y ejecutan como texto plano. No necesitan preparaci
 
 En este aspecto, JavaScript es muy diferente a otro lenguaje llamado [Java](<https://es.wikipedia.org/wiki/Java_(lenguaje_de_programaci%C3%B3n)>).
 
-```smart header="¿Por qué <u>Java</u>Script?"
+```smart header="¿Por qué se llama <u>Java</u>Script?"
 Cuando JavaScript fue creado, inicialmente tenía otro nombre: "LiveScript". Pero Java era muy popular en ese momento, así que se decidió que el posicionamiento de un nuevo lenguaje como un "Hermano menor" de Java ayudaría.
 
 Pero a medida que evolucionaba, JavaScript se convirtió en un lenguaje completamente independiente con su propia especificación llamada [ECMAScript] (https://es.wikipedia.org/wiki/ECMAScript), y ahora no tiene ninguna relación con Java.
@@ -38,7 +38,7 @@ Los motores son complicados, pero los fundamentos son fáciles.
 2.- Entonces convierte ("compila") el script a lenguaje máquina.
 3.- y por último el código maquina se ejecuta muy rápido.
 
-El motor aplica optimizaciones en cada paso del proceso. Incluso observa como el script compilado se ejecuta, analiza los datos que fluyen a través de él y aplica optimizaciones al código maquina basadas en ese conocimiento. Cuando está terminado, los scripts se ejecutan bastante rápido.
+El motor aplica optimizaciones en cada paso del proceso. Incluso observa como el script compilado se ejecuta, analiza los datos que fluyen a través de él y aplica optimizaciones al código maquina basadas en ese conocimiento.
 ```
 
 ## ¿Qué puede hacer JavaScript en el navegador?

diff --git a/1-js/01-getting-started/4-devtools/bug.html b/1-js/01-getting-started/4-devtools/bug.html
@@ -7,7 +7,7 @@
 
 <body>
 
-  Hay un error en el script de ésta página.
+  Hay un error en el script de esta página.
   <script>
     lalala
   </script>

diff --git a/1-js/02-first-steps/01-hello-world/1-hello-alert/solution.md b/1-js/02-first-steps/01-hello-world/1-hello-alert/solution.md
@@ -1 +1,2 @@
-[html src="index.html"]
+
+[html src="index.html"]
diff --git a/1-js/02-first-steps/02-structure/article.md b/1-js/02-first-steps/02-structure/article.md
@@ -94,7 +94,7 @@ Pero deberían ser dos sentencias separadas, no una. Tal unión en este caso es
 
 Recomendamos colocar puntos y coma entre las sentencias, incluso si están separadas por saltos de línea. Esta regla está ampliamente adoptada por la comunidad. Notemos una vez más que es posible omitir los puntos y coma la mayoría del tiempo. Pero es más seguro, especialmente para un principiante, usarlos.
 
-## Comentarios
+## Comentarios [#code-comments]
 
 A medida que pasa el tiempo, los programas se vuelven cada vez más complejos. Se hace necesario agregar *comentarios* que describan lo que hace el código y por qué.
 
@@ -136,7 +136,7 @@ alert('Mundo');
 ```
 
 ```smart header="¡Usa accesos rápidos del teclado!"
-En la mayoría de los editores, se puede comentar una línea de código presionando `key:Ctrl+/` para un comentario de una sola línea y algo como `key:Ctrl+Shift+/` - para comentarios de varias líneas (selecciona una parte del código y pulsa la tecla de acceso rápido). Para Mac, intenta `key: Cmd` en lugar de `key: Ctrl`.
+En la mayoría de los editores, se puede comentar una línea de código presionando `key:Ctrl+/` para un comentario de una sola línea y algo como `key:Ctrl+Shift+/` - para comentarios de varias líneas (selecciona una parte del código y pulsa la tecla de acceso rápido). Para Mac, intenta `key: Cmd` en lugar de `key: Ctrl` y `key:Option` en lugar de `key:Shift`.
 ```
 
 ````warn header="¡Los comentarios anidados no son admitidos!"

diff --git a/1-js/02-first-steps/04-variables/article.md b/1-js/02-first-steps/04-variables/article.md
@@ -203,7 +203,7 @@ let имя = '...';
 let 我 = '...';
 ```
 
-Técnicamente, no existe ningún error aquí, tales nombres están permitidos, pero existe una tradición internacional de utilizar inglés en el nombramiento de variables. Incluso si estamos escribiendo un script pequeño, este puede tener una larga vida por delante. Puede ser necesario que gente de otros países deba leerlo en algún momento.
+Técnicamente, no existe ningún error aquí. Tales nombres están permitidos, pero existe una tradición internacional de utilizar inglés en el nombramiento de variables. Incluso si estamos escribiendo un script pequeño, este puede tener una larga vida por delante. Puede ser necesario que gente de otros países deba leerlo en algún momento.
 ````
 
 ````warn header="Nombres reservados"
@@ -267,7 +267,7 @@ Existe una práctica utilizada ampliamente de utilizar constantes como aliases d
 
 Tales constantes se nombran utilizando letras mayúsculas y guiones bajos.
 
-Por ejemplo:
+Por ejemplo, creemos constantes para los colores en el formato "web" (hexadecimal):
 
 ```js run
 const COLOR_RED = "#F00";
@@ -303,7 +303,7 @@ En otras palabras, las constantes nombradas con mayúscula son utilizadas como
 
 Estando en el tema de las variables, existe una cosa de mucha importancia.
 
-Por favor se sensato al nombrar tus variables. Pensémolo por un momento.
+Una variable debe tener un nombre claro, de significado evidente, que describa el dato que almacena.
 
 Nombrar variables es una de las habilidades más importantes y complejas en la programación. Un vistazo rápido a el nombre de las variables nos revela cuál código fue escrito por un principiante o por un desarrollador experimentado.