Merge branch 'master' into shallow-renderer-spanish-translation

Author: tesseralis

README.md

@@ -57,9 +57,10 @@ The documentation is divided into several sections with a different tone and pur
 
 ## Translation
 
-If you are interesting in translating `reactjs.org`, please join the Crowdin.
+If you are interesting in translating `reactjs.org`, please see the current translation efforts at [isreacttranslatedyet.com](https://www.isreacttranslatedyet.com/).
 
-* [Crowdin - React](https://crowdin.com/project/react)
+
+If your language does not have a translation and you would like to create one, please follow the instructions at [reactjs.org Translations](https://github.com/reactjs/reactjs.org-translation#translating-reactjsorg).
 
 ## Troubleshooting
 

TRANSLATION.md

@@ -1,33 +1,128 @@
-# Translation
+# Traducción
 
-Current progress: https://github.com/reactjs/es.reactjs.org/issues/4
+Progreso actual: https://github.com/reactjs/es.reactjs.org/issues/4
 
-# Style Guide
+# Guía de estilo
 
-- Leave code blocks untranslated. (It is usually OK to translate comments inside them.)
-- Links to references (MDN, wikipedia) should go to the Spanish version.
-- Use "tú" for the 2nd person singular.
+## Identificadores de los títulos
 
-# Common translations
+Los títulos de las secciones tienen identificadores explícitos de la siguiente manera:
 
-Suggestion on words and terms:
+```md
+## Try React {#try-react}
+```
+
+¡**NO** traduzcas estos identificadores! Se usan para la navegación y no funcionaría correctamente si se hace referencia externamente, o sea:
+
+```md
+Consulta la [sección de inicio](/getting-started#try-react) para más información.
+```
+
+✅ CORRECTO:
+
+```md
+## Prueba React {#try-react}
+```
+
+❌ INCORRECTO:
+
+```md
+## Prueba React {#prueba-react}
+```
+
+Esto hará que el enlace de arriba deje de funcionar.
+
+## Texto en bloques de código
+
+Deja el texto en los bloques de código sin traducir, excepto para los comentarios. Opcionalmente puedes traducir el texto en cadenas, ¡pero cuida de no traducir cadenas que hagan referencia a código!
+
+Ejemplo:
+```js
+// Example
+const element = <h1>Hello, world</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+✅ CORRECTO:
+
+```js
+// Ejemplo
+const element = <h1>Hello, world</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+✅ TAMBIÉN CORRECTO:
+
+```js
+// Ejemplo
+const element = <h1>Hola mundo</h1>;
+ReactDOM.render(element, document.getElementById('root'));
+```
+
+❌ INCORRECTO:
+
+```js
+// Ejemplo
+const element = <h1>Hola mundo</h1>;
+// "root" hace referencia a un indentificador de un elemento.
+// NO LO TRADUZCAS
+ReactDOM.render(element, document.getElementById('raíz'));
+```
+
+❌ DEFINITIVAMENTE INCORRECTO:
+
+```js
+// Ejemplo
+const elemento = <h1>Hola mundo</h1>;
+ReactDOM.hacer(elemento, documento.obtenerElementoPorId('raíz'));
+```
+
+## Enlaces externos
+
+Si un enlace externo es a un artículo en un sitio de referencias como [MDN] o [Wikipedia] y existe una versión de este artículo en español con una calidad aceptable, considera sustituir el enlace por el de esa versión.
+
+[MDN]: https://developer.mozilla.org/en-US/
+[Wikipedia]: https://en.wikipedia.org/wiki/Main_Page
+
+Ejemplo:
+
+```md
+React elements are [immutable](https://en.wikipedia.org/wiki/Immutable_object).
+```
+
+✅ BIEN:
+
+```md
+Los elementos de React son [inmutables](https://es.wikipedia.org/wiki/Objeto_inmutable).
+```
+
+Para enlaces que no tienen un equivalente en español (Stack Overflow, videos de YouTube, etcétera) mantén el enlace en inglés.
+
+## Usted, tú y vos
+
+Para mantener la consistencia y evitar regionalismos decidimos utilizar tú para la segunda persona del singular.
+
+# Traducciones comunes
+
+Aquí hay algunas sugerencias para la traducción de términos de uso común en este tipo de documentación técnica.
 
 | Original word/term | Suggestion |
 | ------------------ | ---------- |
-| array | array |
+| array | *array* |
 | arrow function | función flecha |
 | assert | comprobar |
 | bug | error |
-| Bundler | *Bundler* |
+| bundler | *bundler* |
+| camelCase | *camelCase* |
 | callback | *callback* |
 | camelCase | *camelCase* |
 | controlled component | componente controlado |
 | debugging | depuración |
 | DOM | DOM |
 | framework | *framework* |
-| functional component | componente funcional |
+| function component | componente de función |
 | hook | *hook* |
-| key | key |
+| key | *key* |
 | lazy initialization | inicialización diferida |
 | library | biblioteca |
 | lowercase | minúscula(s) |
@@ -39,6 +134,3 @@ Suggestion on words and terms:
 | string | *string* |
 | template literals | *template literals* |
 | uncontrolled component | componente no controlado |
-
-
-

content/docs/cdn-links.md

@@ -1,37 +1,37 @@
 ---
 id: cdn-links
-title: CDN Links
+title: Enlaces CDN
 permalink: docs/cdn-links.html
 prev: create-a-new-react-app.html
 next: hello-world.html
 ---
 
-Both React and ReactDOM are available over a CDN.
+Ambos React y ReactDOM están disponibles a través de un CDN.
 
 ```html
 <script crossorigin src="https://unpkg.com/react@16/umd/react.development.js"></script>
 <script crossorigin src="https://unpkg.com/react-dom@16/umd/react-dom.development.js"></script>
 ```
 
-The versions above are only meant for development, and are not suitable for production. Minified and optimized production versions of React are available at:
+Las versiones anteriores son solo para el uso en desarrollo, y no son adecuadas para el uso en producción. Las versiones de React minimizadas y optimizadas para el uso en producción están disponibles en:
 
 ```html
 <script crossorigin src="https://unpkg.com/react@16/umd/react.production.min.js"></script>
 <script crossorigin src="https://unpkg.com/react-dom@16/umd/react-dom.production.min.js"></script>
 ```
 
-To load a specific version of `react` and `react-dom`, replace `16` with the version number.
+Para usar una versión específica de `react` y `react-dom`, cambia el `16` con el número de versión.
 
-### Why the `crossorigin` Attribute? {#why-the-crossorigin-attribute}
+### ¿Por qué el atributo `crossorigin`? {#why-the-crossorigin-attribute}
 
-If you serve React from a CDN, we recommend to keep the [`crossorigin`](https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes) attribute set:
+Si utilizas React desde un CDN, nosotros recomendamos mantener el atributo [`crossorigin`](https://developer.mozilla.org/es/docs/Web/HTML/Atributos_de_configuracion_CORS) puesto:
 
 ```html
 <script crossorigin src="..."></script>
 ```
 
-We also recommend to verify that the CDN you are using sets the `Access-Control-Allow-Origin: *` HTTP header:
+También recomendamos verificar que el CDN que estás utilizando establece el encabezado HTTP `Access-Control-Allow-Origin: *`:
 
 ![Access-Control-Allow-Origin: *](../images/docs/cdn-cors-header.png)
 
-This enables a better [error handling experience](/blog/2017/07/26/error-handling-in-react-16.html) in React 16 and later.
+Esto permite una mejor [experiencia en el manejo de errores](/blog/2017/07/26/error-handling-in-react-16.html) en React 16 y versiones posteriores.

content/docs/components-and-props.md

@@ -90,7 +90,7 @@ Recapitulemos lo que sucede en este ejemplo:
 > 
 >React trata los componentes que empiezan con letras minúsculas como etiquetas del DOM. Por ejemplo, `<div />` representa una etiqueta div HTML pero `<Welcome />` representa un componente y requiere que `Welcome` esté en scope.
 > 
-> Puedes leer mas sobre el razonamiento detras de esta convención [aquí.](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized)
+> Para saber más sobre el razonamiento detrás de esta convención, puedes consultar [JSX en profundidad](/docs/jsx-in-depth.html#user-defined-components-must-be-capitalized).
 
 ## Composición de Componentes {#composing-components}
 

content/docs/faq-internals.md

@@ -1,23 +1,23 @@
 ---
 id: faq-internals
-title: Virtual DOM and Internals
+title: DOM virtual y detalles de implementación
 permalink: docs/faq-internals.html
 layout: docs
 category: FAQ
 ---
 
-### What is the Virtual DOM? {#what-is-the-virtual-dom}
+### ¿Qué es el DOM virtual? {#what-is-the-virtual-dom}
 
-The virtual DOM (VDOM) is a programming concept where an ideal, or "virtual", representation of a UI is kept in memory and synced with the "real" DOM by a library such as ReactDOM. This process is called [reconciliation](/docs/reconciliation.html).
+El DOM virtual (VDOM) es un concepto de programación donde una representación ideal o "virtual" de la IU se mantiene en memoria y en sincronía con el DOM "real", mediante una biblioteca como ReactDOM. Este proceso se conoce como [reconciliación](/docs/reconciliation.html).
 
-This approach enables the declarative API of React: You tell React what state you want the UI to be in, and it makes sure the DOM matches that state. This abstracts out the attribute manipulation, event handling, and manual DOM updating that you would otherwise have to use to build your app.
+Este enfoque hace posible la API declarativa de React: le dices a React en qué estado quieres que esté la IU, y se hará cargo de llevar el DOM a ese estado. Esto abstrae la manipulación de atributos, manejo de eventos y actualización manual del DOM que de otra manera tendrías que usar para construir tu aplicación.
 
-Since "virtual DOM" is more of a pattern than a specific technology, people sometimes say it to mean different things. In React world, the term "virtual DOM" is usually associated with [React elements](/docs/rendering-elements.html) since they are the objects representing the user interface. React, however, also uses internal objects called "fibers" to hold additional information about the component tree. They may also be considered a part of "virtual DOM" implementation in React.
+Ya que "DOM virtual" es más un patrón que una tecnología específica, las personas a veces le dan significados diferentes. En el mundo de React, el término "DOM virtual" es normalmente asociado con [elementos de React](/docs/rendering-elements.html) ya que son objetos representando la interfaz de usuario. Sin embargo, React también usa objetos internos llamados "fibers" para mantener información adicional acerca del árbol de componentes. Éstos pueden ser también considerados como parte de la implementación de "DOM virtual" de React.
 
-### Is the Shadow DOM the same as the Virtual DOM? {#is-the-shadow-dom-the-same-as-the-virtual-dom}
+### ¿Es el Shadow DOM lo mismo que el DOM virtual? {#is-the-shadow-dom-the-same-as-the-virtual-dom}
 
-No, they are different. The Shadow DOM is a browser technology designed primarily for scoping variables and CSS in web components. The virtual DOM is a concept implemented by libraries in JavaScript on top of browser APIs.
+No, son diferentes. El Shadow DOM es una tecnología de los navegadores diseñada principalmente para limitar el alcance de variables y CSS en componentes web. El DOM virtual es un concepto que implementan bibliotecas en JavaScript por encima de las APIs de los navegadores.
 
-### What is "React Fiber"? {#what-is-react-fiber}
+### ¿Qué es "React Fiber"? {#what-is-react-fiber}
 
-Fiber is the new reconciliation engine in React 16. Its main goal is to enable incremental rendering of the virtual DOM. [Read more](https://github.com/acdlite/react-fiber-architecture).
+Fiber es el nuevo motor de reconciliación en React 16. Su principal objetivo es permitir el renderizado incremental del DOM virtual. [Leer más](https://github.com/acdlite/react-fiber-architecture).