Merge branch 'master' of github.com:reactjs/es.reactjs.org into handling-events-translation

Author: simonhoyos

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,41 +1,135 @@
-# 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* |
-| camelCase | *camelCase* |
+| bundler | *bundler* |
 | 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) |
 | props | *props* |
 | React element | Elemento de React |
 | render | renderizar (verb), renderizado (noun)
+| shallow rendering | renderizado superficial |
 | state | estado |
 | string | *string* |
 | template literals | *template literals* |
 | uncontrolled component | componente no controlado |
-
-
-