Merge branch 'master' into Debugging-in-Chrome

Author: vplentinax

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

@@ -1,10 +1,10 @@
 # Una introducción a JavaScript
 
-Veamos que tiene de especial JavaScript, que podemos lograr con este lenguaje y que otras tecnologías se integran bien con él.
+Veamos qué tiene de especial JavaScript, qué podemos lograr con este lenguaje y qué otras tecnologías se integran bien con él.
 
 ## ¿Qué es JavaScript?
 
-_JavaScript_ Fue creado para _"dar vida a la páginas web"_.
+_JavaScript_ Fue creado para _"dar vida a las páginas web"_.
 
 Los programas en este lenguaje son llamados _scripts_. Se pueden escribir directamente en el HTML de una página web y ejecutarse automáticamente a medida que se carga la página.
 

1-js/01-getting-started/2-manuals-specifications/article.md

@@ -0,0 +1,42 @@
+
+# Manuales y especificaciones
+
+Este libro es un *tutorial*. Su objetivo es ayudarte a aprender el lenguaje gradualmente. Pero una vez que te familiarices con lo básico, necesitarás otras fuentes.
+
+## Especificación
+
+[La especificación ECMA-262](https://www.ecma-international.org/publications/standards/Ecma-262.htm) contiene la información más exhaustiva, detallada, y formal sobre JavaScript. En ella se define el lenguaje.
+
+Pero por su estilo formal, es difícil de entender a primeras. Así que si necesitas la fuente de información más fiable sobre los detalles del lenguaje, esta especificación es el lugar correcto a consultar. Es de entender entonces que no es para el uso diario.
+
+Una nueva versión de la especificación del lenguaje es publicada anualmente. Entre publicaciones, el último borrador de la especificación se puede consultar en <https://tc39.es/ecma262/>.
+
+Para leer acerca de las nuevas prestaciones de vanguardia del lenguaje, incluyendo aquellas que son "cuasi-estándar" (apodado "stage 3"), encuentra las propuestas en <https://github.com/tc39/proposals>.
+
+Si estás desarrollando para navegadores web, se mencionan otras especificaciones en la [segunda parte](info:browser-environment) del tutorial.
+
+## Manuales
+
+- **MDN (Mozilla) JavaScript Reference** es un manual con ejemplos y otras informaciones. Es fantástico para obtener información exhaustiva sobre funciones individuales del lenguaje, métodos, etc.
+
+    Se puede acceder en <https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference>.
+
+    Aunque a menudo es mejor hace una búsqueda en internet, adicionando "MDN [término]" como parte de la *query* en el motor de búsqueda, e.g. <https://google.com/search?q=MDN+parseInt> para buscar la función `parseInt`.
+
+
+- **MSDN** – Manual de Microsoft con mucha información, incluyendo JavaScript (a menudo denominado JScript). Si se necesita información específica de Internet Explorer, es el mejor lugar a consultar: <http://msdn.microsoft.com/>.
+
+    También podemos hacer una búsqueda con frases tales como "RegExp MSDN" o "RegExp MSDN jscript".
+
+## Tablas de compatibilidad
+
+JavaScript es un lenguaje en evolución, nuevas características son adicionadas regularmente.
+
+Para ver la compatibilidad por navegador y otros motores, consultar:
+
+- <http://caniuse.com> - tablas de compatibilidad por característica, e.g. para comprobar qué motores soportan funciones modernas de criptografía: <http://caniuse.com/#feat=cryptography>.
+- <https://kangax.github.io/compat-table> - tabla que muestra la compatibilidad o no de las prestaciones del lenguaje por motor.
+
+Todos estos recursos son de utilidad para el desarrollo con JavaScript, ya que incluyen información valiosa sobre los detalles del lenguaje, su compatibilidad, etc.
+
+Por favor, tenlos en cuenta (o esta página) para cuando necesites información exhaustiva sobre una característica determinada.

1-js/01-getting-started/2-code-editors/article.md renamed to 1-js/01-getting-started/3-code-editors/article.md

@@ -1,3 +1,3 @@
-# An introduction
+# Una introducción
 
-About the JavaScript language and the environment to develop with it.
+Acerca del lenguaje JavaScript y del ambiente para desarrollar con él.