Bienvenido a la localización de MDN en español

Puedes comenzar en la siguiente guía de contribución

Pasos para configurar el entorno local

Puedes ver: https://youtu.be/pFeW0vUYbkg

Pasos para abrir un Pull Request

Desde tu computadora

Crear rama, hacer commit, crear pull request, esperar revisiones.

Acceder a GitHub: https://github.com/login/

Ir a https://github.com/mdn/translated-content

hacer Fork al repositorio en nuestra cuenta de GitHub.

Clonar el repositorio de nuestra cuenta de GitHub git clone git@github.com:TU_USUARIO/translated-content.git

cd translated-content #Entrar al directorio

git switch -c patch-error-on-123-issue #Crear rama para trabajar

Hacer nuestros cambios

git add files/es/archivo.md #Agregamos los archivos modificados

git rm files/es/archivo.html #Removemos los archivos eliminados (si los hubiera)

git commit -m "Corregido el error 123 [es]" #Hacemos commit con una descripción de lo realizado y agregamos [es]

git push -u origin patch-error-on-123-issue #Subimos nuestra rama a nuestro repositorio

Ir a nuestro repositorio https://github.com/TU_USUARIO/translated-content y solicitar el Pull Request

A continuación puedes ver un ejemplo en video: https://youtu.be/pFeW0vUYbkg

Pasos para traducir un documento

Ejemplificaremos el proceso a realizar cuando se desea traducir el contenido de una página. Ejemplo:

Digamos que desea traducir el contenido de la página que se observa en esta dirección.

Buscar la versión original (en inglés) del documento que desea traducir. Debería buscar en el repositorio en inglés (mdn/content) el archivo correspondiente al documento, en este caso la dirección sería files/en-us/web/javascript/reference/global_objects/array/index.md
Buscar la versión en español del documento que desea traducir. En este caso la dirección seria files/es/web/javascript/reference/global_objects/array/index.{html|md}
NOTA:
- Si el archivo no existe, deberá crearlo en formato Markdown imitando la ruta que tiene la versión en inglés.
- Es posible que el archivo en la versión en español se encuentre en formato HTML, en cuyo caso tendrá que reemplazarlo por el formato Markdown.
Utilizar el texto y formato en inglés como guía para traducir al español.

Arreglar "flaws" (defectos)

Al usar yarn start en localhost para el repositorio mdn/content, es posible ver una previsualización en tu servidor local de los cambios que has hecho y como lucirán. Esto también es posible creando un PR, el bot se encargará de generar una "preview URL" donde puedes observar el mismo resultado. En ambas pantallas, podrás, en la parte superior del documento, mostrar los "flaws" que el motor indique, y que contendrá aquellos defectos detectados de manera automática para ser corregidos, y, en algunos casos, la corrección disponible con un clic, o una sugerencia.

Convención en traducciones

La comunidad de español sugiere utilizar las siguientes convenciones al traducir el contenido.

Término original	Traducción
Event listener	Detector de eventos
Event handler	Manejador de eventos
See also	Véase también
Specifications	Especificaciones
Browser compatibility	Compatibilidad con navegadores
HTML Content o HTML	HTML
JavaScript Content o JavaScript	JavaScript
Warning	Advertencia
Framework	Framework