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

GLOSARIO

Open
#225 11 comments 0 reactions 0 assignees View on GitHub
Dominant language
HTML
Stars
625
Forks
226
PR merge metrics
No merged PRs in 30d

Description

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.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the glossary rules, translation exceptions, punctuation guidance, and link schemes in this issue. Check the comment thread for any settled terminology or unresolved suggestions; the work is complete only when the glossary policy and its accepted terms are agreed and documented.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation, localization
Issue type
Documentation
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.