javascript-tutorial / javascript-tutorial/es.javascript.info

GLOSARIO

Abierto
#225 11 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Lenguaje dominante
HTML
Estrellas
626
Forks
226
Métricas de merge de PR
Sin PR fusionados en 30 d

Descripción

En común acuerdo, hemos decidido definir un único glosario para la consistencia de las traducciones. Si desea comunicar alguna sugerencia, deje su comentario.
## No se traducen
- [Palabras claves](https://wiki.developer.mozilla.org/es/docs/Web/JavaScript/Referencia/Gramatica_lexica#Palabras_clave) del lenguaje.
- Archivos SVG (traducción por susstitución de textos, detalles en el git del server)
- Ejemplos de código, es decir, ni variables, ni clases, ni nombres de funciones. (Los comentarios si pueden ser traducidos)
- Contenido precedido por tres comillas por ejemplo: ` ```js run` , ` ```html run no-beautify` o ` ```smart header=" "` pero en este caso sí se traduce el contenido de las comillas dobles " ".
- Texto **Lorem Ipsum**

## A elección del traductor:
- Array
- String
- Callback
- Wrapper

## El doble dash "--"
markdown que el server muestra como " — " (no se ve asi en el md de github)
La sugerencia es cambiarlo por ":" (o coma, parentesis, segun contexto)
En listas, podemos dejarlo:
opcion tal — hace tal,
opcion tal — hace tal,

## Puntos suspensivos vs ellipsis "..."
La gramática es diferente: va pegado a la palabra anterior y con un espacio después. Continúa en minúscula si no termina una oración.
El significado también es ligeramente distinto y no queda bien en principios de oración, ver en contexto.

## Esquemas de links.
(MDN: ) Links a mozilla //developer.mozilla.org, NO usar ese esquema, reemplazarlo por la URL completa (al español si existe)
( info : aaa # ttt ) internos a javascript.info. Esperar por la resolución del issue, el original inglés no tiene anchor necesarios [# ].

## Términos alfabéticamente.

- `arguments` [arguments](https://javascript.info/rest-parameters-spread#the-arguments-variable)
Es un objeto incorporado al lenguaje, similar a un array que contiene todos los argumentos. En este caso no se traduce. En cambio si se refiere a los argumentos de una función se puede traducir.

- **Accessor**
Métodos de acceso.

- **Default** "por defecto", aunque "predeterminado" suena más claro.

- **Event Handler**, o simplemente **handler** se traduce Controlador de Eventos, o controlador
(sin acuerdo, prefiero handler o manejador para la función simple, y reservar controlador para los objetos controller).

- **Flag**
Indicador, bandera. Es más banderín que bandera, se usa para señalizar algo verdadero/falso.

- **Gotcha** (Got you!) o cazabobos, que es un poco agresivo.
La mejor traducción es *"trampa"*, ya que hace referencia a que un resultado fue inesperado o sorpresivo.

- **Key**
Se traduce como *"clave"*.

- **Provides**
"Brinda" suena más lindo que "provee".

- **Sandbox**, **Sandboxed**, **Sandboxing**
"Entorno controlado", o simplemente se puede dejar como Sandbox.

- **Wrapper**
Contenedor. Envoltorio, una función que envuelve a otra añadiéndole funcionalidad.

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Empieza revisando las reglas del glosario, las excepciones de traducción, las indicaciones de puntuación y los esquemas de enlaces de este issue. Revisa el hilo de comentarios para comprobar si hay terminología ya acordada o sugerencias sin resolver; el trabajo solo está completo cuando la política del glosario y sus términos aceptados se hayan acordado y documentado.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
javascript
Área
documentation, localization
Tipo de issue
Documentación
Dificultad
5/5
Tiempo estimado
Más de una semana
Estado de actividad
Estancado
Claridad
Necesita aclaración
Aptitud para principiantes
25/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.