Merge branch 'master' into code-structure

Author: tscandalitta

1-js/01-getting-started/1-intro/article.md

@@ -77,7 +77,7 @@ Ejemplos de tales restricciones incluyen:
 
 - JavaScript puede fácilmente comunicarse a través de la red con el servidor de donde esta página proviene. Pero su capacidad para recibir información de otros sitios y dominios esta bloqueada. Aunque sea posible, esto requiere un acuerdo explícito (expresado en los encabezados HTTP) desde el sitio remoto. Una vez más, esto es una limitación de seguridad.
 
-![](limitations.png)
+![](limitations.svg)
 
 Tales limitaciones no existen si JavaScript es usado fuera del navegador, por ejemplo, en un servidor. Los navegadores modernos también permiten complementos y extensiones que pueden preguntar por permisos extendidos.
 

1-js/01-getting-started/1-intro/limitations.png

@@ -50,6 +50,12 @@ Open Preferences and go to the "Advanced" pane. There's a checkbox at the bottom
 
 Now `key:Cmd+Opt+C` can toggle the console. Also, note that the new top menu item named "Develop" has appeared. It has many commands and options.
 
+## Multi-line input
+
+Usually, when we put a line of code into the console, and then press `key:Enter`, it executes.
+
+To insert multiple lines, press `key:Shift+Enter`.
+
 ## Summary
 
 - Developer tools allow us to see errors, run commands, examine variables, and much more.

1-js/01-getting-started/1-intro/limitations.svg

@@ -6,7 +6,7 @@ Lo primero que estudiaremos son los bloques de construcción del código.
 
 Las declaraciones son construcciones de sintaxis y comandos que realizan acciones.
 
-Ya hemos visto una declaración, `alert('¡Hola, mundo!')`, Que muestra el mensaje "¡Hola mundo!".
+Ya hemos visto una sentencia, `alert('¡Hola, mundo!')`, que muestra el mensaje "¡Hola mundo!".
 
 Podemos tener tantas declaraciones en nuestro código como queramos. Las declaraciones se pueden separar con un punto y coma.
 
@@ -157,4 +157,5 @@ Por favor, no dudes en comentar tu código.
 
 Los comentarios aumentan el tamaño general del código, pero eso no es un problema en absoluto. Hay muchas herramientas que minimizan el código antes de publicar en un servidor de producción. Eliminan los comentarios, por lo que no aparecen en los scripts de trabajo. Por lo tanto, los comentarios no tienen ningún efecto negativo en la producción.
 
-Más adelante en el tutorial habrá un capítulo <info:coding-style> que también explica cómo escribir mejores comentarios.
+Más adelante, en el tutorial, habrá un capítulo <info:coding-style> que también explica cómo escribir mejores comentarios.
+

1-js/01-getting-started/1-intro/limitations@2x.png

@@ -1,61 +1,78 @@
-# The modern mode, "use strict"
+# El modo moderno, "use strict"
 
-For a long time, JavaScript evolved without compatibility issues. New features were added to the language while old functionality didn't change.
+Durante mucho tiempo, JavaScript evolucionó sin problemas de compatibilidad. Se añadían nuevas características al lenguaje sin que la funcionalidad existente cambiase.
 
-That had the benefit of never breaking existing code. But the downside was that any mistake or an imperfect decision made by JavaScript's creators got stuck in the language forever.
+Esto tenía el beneficio de nunca romper código existente, pero lo malo era que cualquier error o decisión imperfecta tomada por los creadores de JavaScript se quedaba para siempre en el lenguage.
 
-This was the case until 2009 when ECMAScript 5 (ES5) appeared. It added new features to the language and modified some of the existing ones. To keep the old code working, most modifications are off by default. You need to explicitly enable them with a special directive: `"use strict"`.
+Esto fue así hasta 2009, cuando ECMAScript 5 (ES5) apareció. Esta versión añadío nuevas características al lenguaje y modificó algunas de las ya existentes. Para mantener el código antiguo funcionando, la mayor parte de las modificaciones están desactivadas por defecto. Tienes que activarlas explícitamente usando una directiva especial: `"use strict"`.
 
 ## "use strict"
 
-The directive looks like a string: `"use strict"` or `'use strict'`. When it is located at the top of a script, the whole script works the "modern" way.
+La directiva se asemeja a un string: `"use strict"`. Cuando se sitúa al principio de un script, el script entero funciona de la manera "moderna".
 
-For example:
+Por ejemplo:
 
 ```js
 "use strict";
 
-// this code works the modern way
+// este código funciona de la manera moderna
 ...
 ```
 
-We will learn functions (a way to group commands) soon.
+Aprenderemos funciones (una manera de agrupar comandos) en breve.
 
-Looking ahead, let's just note that `"use strict"` can be put at the start of most kinds of functions instead of the whole script. Doing that enables strict mode in that function only. But usually, people use it for the whole script.
+De cara al futuro, tengamos en cuenta que `"use strict"` se puede poner al inicio de la mayoría de los tipos de funciones en lugar del script entero. De esta manera, se activa el modo estricto únicamente en esa función. Pero, normalmente, la gente lo utiliza para el script entero.
 
+````warn header="Asegúrate de que \"use strict\" está al inicio"
+Por favor, asegúrate de que `"use strict"` está al principio de tus scripts. Si no, el modo estricto podría no estar activado.
 
-````warn header="Ensure that \"use strict\" is at the top"
-Please make sure that `"use strict"` is at the top of your scripts, otherwise strict mode may not be enabled.
-
-Strict mode isn't enabled here:
+El modo estricto no está activado aquí:
 
 ```js no-strict
-alert("some code");
-// "use strict" below is ignored--it must be at the top
+alert("algo de código");
+// la directiva "use strict" de abajo es ignorada, tiene que estar al principio
 
 "use strict";
 
-// strict mode is not activated
+// el modo estricto no está activado
 ```
 
-Only comments may appear above `"use strict"`.
+Únicamente pueden aparecer comentarios por encima de `"use strict"`.
 ````
 
-```warn header="There's no way to cancel `use strict`"
-There is no directive like `"no use strict"` that reverts the engine to old behavior.
+````warn header="No hay manera de cancelar `use strict`"
+No hay ninguna directiva del tipo `"no use strict"` que haga al motor volver al comportamiento anterior.
+
+Una vez entramos en modo estricto, no hay vuelta atrás.
+````
+
+## Consola del navegador
+
+A partir de ahora, cuando utilices la consola del navegador para probar características, ten en cuenta que no utiliza `use strict` por defecto.
+
+En ocasiones, cuando `use strict` causa una diferencia, obtendrás resultados incorrectos.
+
+Incluso si pulsamos `key:Shift+Enter` para ingresar múltiples líneas y ponemos `use strict` al principio, no funciona. Esto es por cómo la consola ejecuta el código internamente.
+
+La única manera confiable de asegurar que `use strict` funcionará sería escribir el código en la consola de la siguiente forma:
+
+```js
+(function() {
+  'use strict';
 
-Once we enter strict mode, there's no return.
+  // ...tu código...
+})()
 ```
 
-## Always "use strict"
+## Utiliza siempre "use strict"
 
-We have yet to cover the differences between strict mode and the "default" mode.
+Aún tenemos que comentar las diferencias entre el modo estricto y el modo "por defecto".
 
-In the next chapters, as we learn language features, we'll note the differences between the strict and default modes. Luckily, there aren't many and they actually make our lives better.
+En los siguientes capítulos, según aprendamos características del lenguaje, veremos las diferencias entre los modos estricto y por defecto. Afortunadamente, no hay tantas y, de hecho, nos hacen la vida más fácil.
 
-For now, it's enough to know about it in general:
+De momento, es suficiente saber lo general:
 
-1. The `"use strict"` directive switches the engine to the "modern" mode, changing the behavior of some built-in features. We'll see the details later in the tutorial.
-2. Strict mode is enabled by placing `"use strict"` at the top of a script or function. Several language features, like "classes" and "modules", enable strict mode automatically.
-3. Strict mode is supported by all modern browsers.
-4. We recommended always starting scripts with `"use strict"`. All examples in this tutorial assume strict mode unless (very rarely) specified otherwise.
+1. La directiva `"use strict"` cambia el motor de ejecución al modo "moderno", modificando el comportamiento de algunas características incluídas en el lenguaje. Veremos los detalles más adelante.
+2. El modo estricto se habilita poniendo `"use strict"` al principio de una función o del script. Varias características del lenguaje, como las "clases" y los "módulos", activan el modo estricto automáticamente.
+3. El modo estricto funciona en todos los navegadores modernos.
+4. Recomendamos empezar todos los scripts siempre con `"use strict"`. Todos los ejemplos de este tutorial asumen que el modo estricto está activado excepto cuando (muy raramente) se especifica lo contrario.

1-js/01-getting-started/3-devtools/article.md

@@ -1,7 +1,7 @@
-In the code below, each line corresponds to the item in the task list.
+En el siguiente código, cada línea corresponde al elemento en la lista de tareas.
 
 ```js run
-let admin, name; // can declare two variables at once
+let admin, name; // Puedes declarar dos variables a la vez.
 
 name = "John";