Nota sobre el lenguaje
Por qué este sitio dice «haz un commit» y no «confirma los cambios»
Escribir sobre software en español no tiene convención asentada. No hay una autoridad que lo dicte, las guías de estilo de las grandes empresas se contradicen en los bordes, y cada equipo acaba resolviéndolo texto a texto. Nosotros también lo hacíamos así. Esto es lo que decidimos en su lugar.
El criterio
Una palabra se queda en inglés por dos motivos distintos. Confundirlos es fácil, y es el error que nos hizo reescribir esta política entera.
Uno: es un identificador. Aparece tal cual en la línea de comandos, en una API, en un mensaje de error que vas a pegar en un buscador. Traducirlo rompe la referencia: el texto se lee bien y ya no te sirve para nada, porque no puedes volver de él a la herramienta. Vale para cualquier idioma — no es una opinión sobre el español.
Dos: no hay palabra fiel. Ninguna palabra española carga el concepto sin desplazarlo. Traducirlo rompe el concepto. «Compuerta» lo manda a la electrónica; «puerta» ya significa otra cosa aquí; «umbral» pierde que es una condición tipada; «punto de control» pierde que bloquea. Cada candidato parece razonable y cada uno pierde algo distinto. Esto sí es una afirmación sobre el español, y en otro idioma podría ser falsa.
Y si el español sí tiene la palabra, la usamos. Sin complejos y sin nostalgia. Que un término se parezca al nombre de un fichero no lo vuelve intraducible.
Eso resuelve, de paso, la pregunta que parecía no tener respuesta. «¿Cómo se dice run en español?» no la tiene porque no es un término: es una palabra inglesa cualquiera, y según la frase será ejecutar, una ejecución o una pasada. Pero un Run con su identificador y su registro sí es una entidad, y se queda. Buscábamos una traducción para dos cosas distintas; por eso no aparecía.
Lo que no traducimos
Se quedan en inglés, y la última columna dice por cuál de los dos motivos.
| Término | Qué es | Por qué se queda |
|---|---|---|
gate | una gate — la comprobación que corta el paso: si no se cumple, el cambio no llega a ocurrir; no avisa, impide | no hay palabra española fiel — traducirlo rompe el concepto |
sensor | un sensor — la comprobación que se dispara después de generar; en ontoref, además, declara qué miró | SourceLanguage |
ambient affordances | ambient affordances — propiedades que hacen un entorno legible sin instrucciones; se ve qué se puede hacer con solo mirar | no hay palabra española fiel — traducirlo rompe el concepto |
Hard | `Hard` — severidad tipada de una restricción: vincula, y una violación rompe; su par es `Soft`, que se audita y no bloquea | es un identificador — traducirlo rompe la referencia |
commit | un commit — cada vez que guardas un cambio en git queda uno: una foto del proyecto en ese instante, con su mensaje y su autor | es un identificador — traducirlo rompe la referencia |
push | un push — subir tus commits al servidor donde vive el repositorio compartido; hasta entonces solo existen en tu máquina | es un identificador — traducirlo rompe la referencia |
rebase | un rebase — coger tus commits y volver a aplicarlos encima de la rama ya actualizada, como si los hubieras hecho después | es un identificador — traducirlo rompe la referencia |
pull request | un Pull Request — pedir que tus cambios entren en la rama principal, y que alguien los mire antes de que entren | es un identificador — traducirlo rompe la referencia |
hook | un hook — un programa que la herramienta ejecuta sola en un momento fijo: por ejemplo, justo antes de aceptar un commit | es un identificador — traducirlo rompe la referencia |
NCL | NCL — el lenguaje de configuración tipada en el que se declara todo esto | es un identificador — traducirlo rompe la referencia |
ADR | un ADR — el registro de una decisión de arquitectura, con sus restricciones | es un identificador — traducirlo rompe la referencia |
DAG | un DAG — grafo dirigido acíclico: pasos con dependencias y sin ciclos; la forma que tiene un modo | es un identificador — traducirlo rompe la referencia |
JSONL | JSONL — un objeto JSON por línea; el formato del testigo | es un identificador — traducirlo rompe la referencia |
Ed25519 | Ed25519 — la firma criptográfica con la que se sella un testigo: cualquiera puede comprobar que nadie lo ha tocado después | es un identificador — traducirlo rompe la referencia |
exit | exit — el código de salida de un proceso (0 = pasa) | es un identificador — traducirlo rompe la referencia |
CustomerSupplier | CustomerSupplier — dependencia de una vía: un dominio consume a otro sin reciprocidad; un plano degenerado. | es un identificador — traducirlo rompe la referencia |
Partnership | Partnership — vínculo mutuo: ninguno gobierna al otro pero cada uno exige al otro para existir; el 2-ciclo que constituye un plano. | es un identificador — traducirlo rompe la referencia |
OpenHostService | OpenHostService — un dominio publica un servicio/protocolo abierto que varios consumidores usan sin negociar caso a caso. | es un identificador — traducirlo rompe la referencia |
Conformist | Conformist — el consumidor se pliega al modelo del proveedor sin traducción, aceptando su lenguaje tal cual. | es un identificador — traducirlo rompe la referencia |
SharedKernel | SharedKernel — dos dominios comparten un núcleo común de modelo/código, con cambios coordinados. | es un identificador — traducirlo rompe la referencia |
AnticorruptionLayer | AnticorruptionLayer — capa de traducción que aísla el modelo propio del de otro dominio para no contaminarlo (p. ej. la frontera del deck). | es un identificador — traducirlo rompe la referencia |
Lo que sí traducimos
El español carga el concepto entero. No hay nada que preservar.
| En inglés | Aquí decimos |
|---|---|
| witness | testigo |
| door | puerta |
| bond | vínculo |
| node | nodo |
| plane | plano |
| axis | eje |
| edge | arista |
| guide | guía |
| harness | arnés |
| harnessability | arnesabilidad |
| drift | deriva |
| workflow | flujo de trabajo |
| fixture | configuración de prueba |
| guardrail | salvaguarda |
| guardrails | salvaguardas |
| red-team | prueba adversaria |
| onboarding | incorporación |
| onboarded | incorporado |
| scripted | automatizado |
| FSM | máquina de estados |
| flag | opción de línea de comandos |
| runtime | tiempo de ejecución |
| backlog | cartera de pendientes |
| seed | semilla |
| constraint | restricción |
| constraints | restricciones |
| modes | modos |
| schema | esquema |
| reflection | reflexión |
| ontology | ontología |
| merge | fusión |
| parse | analizar |
| deploy | desplegar |
| link | enlazar |
| log | registrar |
| build | compilar |
| debug | depurar |
| test | prueba |
| fork | bifurcación |
| library | biblioteca |
| run | ejecución |
Los verbos, que son el problema de verdad
Aquí es donde todo el mundo se atasca, y la solución no es cuestión de gusto sino de gramática.
Un préstamo sustantivo es inofensivo: entra en español, elige género y ya está. El commit. La branch. No negocia nada más.
Un préstamo verbo, en cambio, está obligado a elegir conjugación — y en español acaba casi siempre en -ear, que arrastra un registro coloquial. Por eso «commitear» chirría y «commit» no: no es el anglicismo, es la morfología. Le estás pidiendo a la palabra inglesa que se conjugue, y eso la marca.
La salida es una construcción que el español ya usa de forma productiva (hacer clic, hacer una copia): verbo español + sustantivo inglés. Hacer un commit. Abrir un Pull Request. Aplicar un rebase. El español pone la gramática; el préstamo se queda quieto, señalando al artefacto.
| No escribimos | Escribimos | Por qué |
|---|---|---|
| evaluar la gate / poner una gate | calco | |
| deriva | calco | |
| hacer un commit | calco | |
| hacer un commit | calco | |
| hacer un push | calco | |
| aplicar un rebase | calco | |
| fusionar | calco | |
| analizar | calco | |
| desplegar | calco | |
| desplegar | calco | |
| enlazar | calco | |
| registrar | calco | |
| compilar | calco | |
| depurar | calco | |
| probar | calco | |
| bifurcar | calco | |
| bifurcar | calco |
Y los que no chirrían — los peligrosos de verdad
Un calco se oye venir. Un falso amigo no: parece la traducción correcta, se lee con fluidez, y desplaza el significado sin que nadie lo note. «Librería» es una tienda; la palabra que buscas es biblioteca. Cada lengua evoluciona sus cognados por su cuenta, y esa deriva es invisible precisamente porque la palabra sigue pareciéndose a su origen.
Otros son cognados de verdad, pero tomados de otra disciplina: «compuerta» viene de la electrónica, y mete la lectura de circuito en una frase que hablaba de transiciones de estado.
| No escribimos | Escribimos | Por qué |
|---|---|---|
| gate | desplaza — Cognato de la ELECTRÓNICA (logic gate). Arrastra la lectura de circuito a una frase sobre transiciones de estado. | |
| gate | desplaza — Ya la usa `door` (la entrada de embudo, ADR-064). Traducir así fusionaría dos conceptos en una palabra. | |
| arnés | desplaza — «armazón» es estructura inerte; el arnés dirige y corrige, no sostiene. | |
| Hard | falso amigo — Traduce el nombre de un valor de tipo como si fuera adjetivo; «fallar en duro» no deja nada que un lector pueda buscar. gateable=false: «d… | |
| Soft | falso amigo — Mismo defecto que «duro», y además sugiere una severidad intermedia que no existe. | |
| hacer un commit | falso amigo — git ENVÍA este locale español y dice «confirmar» — y casi nadie lo usa, porque corta al lector de todo mensaje de error y de toda la do… | |
| hacer un push | falso amigo — «enviar» pierde que el destino es el remoto declarado, no un destinatario cualquiera. NO gateable: la web está llena de «Enviar Mensaje»… | |
| Pull Request | falso amigo — Literal y sin referente: nadie lo reconocería en la forja. | |
| hook | desplaza — «enganche» no nombra nada en la herramienta; el lector no puede volver de la palabra al fichero. | |
| biblioteca | falso amigo — Una librería es una TIENDA. El cognado derivó, y el desplazamiento es invisible precisamente porque la palabra sigue pareciéndose a su ori… | |
| ejecución | regional — Válido en varias variantes americanas; en España evoca la tauromaquia y rompe la frase. Es una elección de REGISTRO, no una corrección �… | |
| ejecuciones | regional — |
Hablando es otra cosa
Nada de lo anterior se aplica a una conversación. «Commiteé y luego mergeé» comunica perfectamente entre quienes trabajan con esto, y escrito sería jerga. La política dice exactamente eso: el calco está prohibido en todo texto y permitido en la boca. Una regla que fingiera lo contrario estaría mintiendo sobre cómo hablamos, y una regla que miente no la cumple nadie.
Un falso amigo, en cambio, engaña igual a quien escucha que a quien lee. Ése se avisa siempre.
Lo mismo vale para la pronunciación. Decir ráuter o dóker dentro de una frase en español no es ignorancia: es acomodación fonológica, y la hacen todas las lenguas que reciben préstamos. Pronunciar el término con fonética inglesa nativa en mitad de una frase en español es la opción marcada — por eso suena a presunción y no a precisión.
Esto no es un aviso legal
La página de al lado es la política de privacidad, y existe porque la ley obliga. Ésta no. Ésta es un contrato de estilo: la analogía correcta no es el aviso legal, sino la licencia o el código de conducta — un documento normativo, publicado, versionado y referenciado.
Con una diferencia respecto a esos dos: éste se ejecuta.
Las tablas que acabas de leer no están escritas a mano. Se generan desde el mismo fichero declarado que revisa cada texto en español de este sitio antes de publicarlo, y que falla la compilación si encuentra una palabra que no debería estar — o si esta página deja de coincidir con la regla que dice explicar.
Que la política lingüística de un proyecto sea a su vez un artefacto declarado, versionado y verificado no es burocracia. Es la tesis del proyecto aplicada a sí misma.
Esta página es una proyección de la política léxica del proyecto. Si encuentras una incoherencia entre lo que dice y lo que lees en el resto del sitio, es un fallo y nos interesa. ontoref@jesusperez.pro