Lista de palabras

Esta sección es la referencia de vocabulario de la guía: qué palabra usa el grupo para cada cosa, cuáles no usa y qué forma toma cada anglicismo. Cubre cuatro temas. Términos de la casa es el diccionario alfabético, adaptado de la lista de palabras de Google y ampliado con los nombres y las convenciones del grupo (cis-admin, cochid-datos, el manual de operación, el archivo societario). Términos que no se usan reúne en una sola tabla lo que está prohibido o se evita, con su reemplazo y la regla de la norma de prosa que lo respalda. Anglicismos y su forma en español fija qué préstamos se traducen, cuáles se quedan en inglés y con qué género, y qué calcos no se aceptan. Resumen de formato de texto condensa en una página cuándo va negrita, cursiva, fuente de código, mayúsculas y comillas.

Si la palabra que buscas no está aquí, consulta el Diccionario de la lengua española y, para dudas de uso, Fundéu. Cuando el diccionario registra dos grafías, usa la primera. Para definiciones técnicas, la documentación oficial de la herramienta manda sobre cualquier diccionario. Las decisiones de terminología dependen del producto, de la audiencia y de la convención vigente; las páginas Jerga, Lenguaje inclusivo, Audiencia global, Guion y Mayúsculas ayudan a tomarlas. Y como en toda la guía, puedes apartarte de una entrada si eso le sirve mejor al lector; documenta la excepción con prosa-ok: <razón> (P07).

Términos de la casa

Nota: esta sección menciona términos que pueden resultar irrespetuosos u ofensivos. Están aquí para dar pautas de uso y ofrecer alternativas.

El diccionario alfabético del grupo. De las casi 600 entradas del original de Google, esta lista conserva y adapta las que tienen sentido en español; las que solo existen por la ortografía inglesa (guiones, grafías dobles) pasaron a Anglicismos y su forma en español, y las atadas a productos de Google se reemplazaron por sus equivalentes del grupo o se descartaron. Cada entrada tiene ancla propia: puedes enlazar directo a glosario.html#nombre-de-la-entrada.

Algunas entradas piden evitar un término o no usarlo. Aplica esa pauta así:

Evitar. El término es ambiguo u oscuro; hay alternativas mejores. Puedes usarlo si hace falta: defínelo en el primer uso o úsalo una sola vez, como explica Jerga.
No usar. El término no se usa en ningún caso: es ambiguo, ofensivo o no inclusivo, o la norma de prosa lo bloquea (el identificador P01..P37 remite a core/prosa/NORMA.md). Si aparece en código, escribe alrededor del término y cítalo en fuente de código.
Etiquetas de ámbito. Algunas pautas aplican solo a un contexto: contabilidad (cis-admin y documentos tributarios), infraestructura (manual de operación, runbooks) o UI (texto de interfaz).

Números y símbolos

+ (signo más): Aceptable con números en texto informal («registros con 300+ atributos»), nunca en contextos formales ni en cifras que sostienen una conclusión: ahí escribe «más de 300». No lo uses para rangos de versiones: «la versión 2.2 o posterior», no «2.2+».
& (et, ampersand): No lo uses en vez de «y» en títulos, texto, navegación ni índices. Aceptable al citar un elemento de UI que lo incluye, y en cabeceras de tabla o etiquetas de diagrama donde el espacio obliga a abreviar. En código, úsalo con su sentido técnico.
Recomendado Facturas y boletas
No recomendado Facturas & boletas
N.º (número): La abreviatura de «número» es «N.º» (o «n.º» en minúscula): «Documento N.º 2026-014», «Ley N.º 19.799». No uses «#», «Nro.» ni «No.». La almohadilla queda para el código y para Markdown.
verificación en dos pasos: En minúscula. Aceptable abreviar «2FA» después de la primera mención. Para el sistema del grupo, di «cis-auth»; Authentik es el nombre interno del software y no se usa con lectores externos.

A

abajo, arriba: No los uses para posiciones en un documento: usa «antes», «más adelante», «anterior», «siguiente». No los uses para rangos de versiones: usa «anterior» y «posterior». No los uses para ubicar elementos de UI; escribe instrucciones que no dependan de la dirección (Accesibilidad). Aceptables en sentido no direccional, como al describir una jerarquía, y en frases hechas («bajo el promedio», «sobre cero»).
Recomendado En el campo Glosa, escribe la descripción.
No recomendado Abajo, en el campo Glosa, escribe la descripción.
abortar: Evítalo en el uso general. Usa «detener», «salir», «cancelar» o «terminar». En Linux, abort es un tipo de señal que termina un proceso anómalo, y en ese sentido técnico puedes citarlo.
acceder: Evítalo cuando un verbo más simple dice lo mismo: «ver», «abrir», «editar», «usar», «consultar». La forma «accesar» no existe en español (ver Anglicismos).
acerca de, sobre: Cuando una referencia cruzada describe de qué trata el destino, usa «sobre»: «Para más información sobre los asientos, consulta…». No acumules «acerca de» y «sobre» en la misma oración.
activar, desactivar: Para opciones e interruptores de UI: «activa Modo oscuro», «desactiva la casilla de sincronización». No «prende», «apaga» ni «enciende». Para funciones y API, usa «habilita» y «deshabilita», y el mismo par en todo el documento (P07). Ver habilitar.
Recomendado Activa Modo oscuro.
No recomendado Prende el Modo oscuro. · Enciende el switch.
actualmente, a la fecha, hoy: Evítalos: el presente ya lo dice el verbo, y la frase envejece con el documento (Documentación atemporal). «Hoy en día» y «en la actualidad» además los marca la norma (P01, P18).
Recomendado cis-admin no emite notas de crédito.
No recomendado Actualmente cis-admin no emite notas de crédito.
ad hoc: Aceptable en contextos de datos y análisis con el sentido de «a medida del caso» («consultas ad hoc contra el lago de datos»). Sin guion y sin cursiva. En otros contextos busca el término preciso: «puntual», «improvisado», «a medida».
administrador: Escribe «administrador» completo en prosa. «Admin» queda para nombres literales: el rol admin, el servicio cis-admin, una etiqueta de UI.
agente: En el grupo, «agente» es una sesión autónoma de Claude Code que ejecuta una tarea. Di «el agente» o «la sesión»; no «la IA» como sujeto que hace cosas (Antropomorfismo).
agnóstico: No lo uses en el sentido de «independiente de»: escribe «independiente de la plataforma», «que funciona con cualquier motor».
alfa, beta: En minúscula, salvo que formen parte del nombre de un producto: «el explorador de medicamentos está en beta».
América, americano: Solo para el continente. Para el país, escribe «Estados Unidos» y «estadounidense»; la abreviatura es «EE. UU.» (con espacio y puntos). No uses «USA», «U.S.» ni «americano» por estadounidense.
AM, PM: No se usan: la casa escribe la hora en formato de 24 horas: «9:00», «14:30», «22:05». Si importa la zona, dila: «14:30 (hora de Santiago, UTC-4)». Ver Fechas y horas.
Recomendado El respaldo corre a las 3:30.
No recomendado El respaldo corre a las 3:30 AM.
antipatrón: Evítalo, sobre todo como título. Di qué evitar y por qué.
Recomendado Evita estos cinco errores de SQL que degradan las consultas.
No recomendado Cinco antipatrones de SQL.
API: Femenino: «la API». Úsalo para una API web o la API de un lenguaje. No lo uses para un método o una clase: «este recurso tiene un método», no «tiene una API». El plural es invariable por escrito: «las API» (Plurales). Escribe «clave de API», no «API key».
app, aplicación: Usa «app» para programas de usuario final, sobre todo móviles o web. «Aplicación» queda para las frases fijas («interfaz de programación de aplicaciones») y para software empresarial cuando quieres transmitir mayor complejidad. «App» es acortamiento, no abreviatura: sin punto (Abreviaturas).
archivo: Un file es un archivo; nunca «fichero». «Nombre de archivo» y «sistema de archivos» van en dos palabras. Ojo con la triple ambigüedad de la casa: el archivo (file), el verbo archivar y «el archivo societario» (el servicio del grupo). Cuando hables del servicio, dilo completo en la primera mención (Audiencia global).
arrastrar: Usa «arrastra», no «haz clic y arrastra» ni «arrastra y suelta». Aceptable «de arrastrar y soltar» como adjetivo.
Recomendado Arrastra el archivo al panel Adjuntos.
No recomendado Arrastra y suelta el archivo en el panel Adjuntos.
asiento: Término de la casa (contabilidad): «asiento contable», con su «glosa» y su estado («borrador», «aprobado»). El objeto de código va en fuente de código: Asiento. No lo mezcles con «comprobante», que es el documento que respalda el asiento.
autenticación y autorización: «Autenticado» se dice de usuarios; «autorizado», de peticiones que una app cliente envía en nombre de un usuario autenticado. Una persona se autentica ante cis-auth con su contraseña; la app queda autorizada para enviar peticiones en su nombre. No uses «authN» ni «authZ».
autoactualizar: No lo uses: escribe «se actualiza automáticamente». Para los demás compuestos con «auto-», el prefijo va pegado y sin guion: «autoescalado», «autocompletar» (Guion).

B

balanceo de carga: La forma de la casa es «balanceo de carga» y «balanceador de carga»; no alternes con «equilibrio de carga» en el mismo documento (P07).
bare metal: Prefiere «servidor físico». «Bare metal» solo si la herramienta que documentas lo usa así, y entonces defínelo en el primer uso.
base64: En minúscula, salvo inicio de oración. En fuente de código solo cuando es un literal citado del código.
billón: En español, un billón es un millón de millones (10¹²). El billion inglés son «mil millones» (10⁹). En una casa que trabaja con cifras fiscales, confundirlos rompe el dato: el gasto público en medicamentos ronda «1,2 billones de pesos» chilenos, que en inglés serían 1.2 trillion. Verifica la magnitud antes de traducir.
Recomendado 4.500 millones de dólares
No recomendado 4,5 billones de dólares (por 4.5 billion)
bitácora: Es el nombre de un servicio interno del grupo. Para los registros de un sistema, di «el log» o «los logs» en documentación de infraestructura, y «el registro» en documentos para lectores no técnicos. Elige uno por documento (P07).
lista de bloqueados, lista de permitidos: No uses blacklist, whitelist ni graylist, en ninguna grafía. Para el sustantivo, usa «lista de bloqueados», «lista de permitidos» o «lista provisional», según el dominio. Considera que a veces ni siquiera hay una lista: sé técnicamente exacto. Para el verbo no traduzcas palabra por palabra; describe la acción.
Recomendado Para rechazar las peticiones de una IP, agrégala a denylist.txt.
No recomendado Para blacklistear una IP, agrégala a denylist.txt.
Si el código usa el término literal, cítalo en fuente de código, aclara a qué se refiere y usa el término nuevo en el resto del documento: «Agrega a la persona a la lista de permitidos (whitelist) con el comando…». Más en Lenguaje inclusivo.
booleano: En minúscula para el tipo abstracto. Si te refieres a la palabra clave de un lenguaje, usa la grafía exacta en fuente de código (bool, BOOLEAN). «Álgebra de Boole» y «lógica booleana» con el nombre propio en mayúscula solo cuando corresponde.
botón: En una UI, un enlace no es un botón: no llames «botón» a un enlace. Usa «botón» para los botones mecánicos (que se presionan) y los táctiles o en pantalla (que se tocan o en los que se hace clic). Ver Elementos de UI e interacción.
break-glass: Escribe «acceso de emergencia» o «procedimiento de respaldo manual». Cita «break-glass» entre paréntesis solo si el lector lo va a encontrar en la herramienta (la consola núcleo lo usa para la llave de emergencia).

C

caché: Femenino y con tilde: «la caché». No uses «cachear»: escribe «guardar en caché», «invalidar la caché». Distingue «acierto de caché» (cache hit) y «dato en caché contra dato fresco» al reportar estado: di el timestamp y si hubo refresco.
campo: El término de la casa para las cajas donde se escribe: «En el campo Glosa, escribe…». No uses «caja de texto», «cuadro de texto» ni «textbox».
capítulo: Solo para libros. Para documentación en línea, habla de documentos, páginas o secciones.
celular, teléfono, dispositivo móvil: «Teléfono» cuando el contexto es claro. «Celular» es la forma americana y es aceptable si la mantienes en todo el documento; para una audiencia global, «teléfono móvil» se entiende en todas partes. Si incluyes tablets, di «dispositivo móvil». «Datos móviles» y «red móvil», no «datos celulares».
chilenismos: No uses coloquialismos locales en documentación: «al tiro», «cachar», «fome», «a la chilena», «pololear un rato con el código». Escribes para una audiencia global en español (Audiencia global). En el canal interno de notas, habla como quieras.
clave: Como sustantivo, di siempre qué clave: «clave de API», «clave privada», «clave primaria», «par de claves». «Clave» a secas es ambiguo y en Chile también significa contraseña; para la contraseña de una cuenta, usa «contraseña». Como adjetivo («factor clave») es español legítimo, pero suele inflar la frase: prefiere «principal» o elimina el énfasis y muestra el dato.
clic, hacer clic: El sustantivo es «clic» (plural «clics»); «click» solo en código o citando UI. La instrucción es «haz clic en», nunca «haz clic sobre», «clickea», «cliquea», «pincha» ni «dale a». «Clic derecho», «doble clic», «clic con la tecla Control presionada». Si la acción expande una lista, puedes escribir «expande». En pantallas táctiles, usa «toca». Ver la tabla de verbos de Elementos de UI e interacción.
Recomendado Haz clic en Guardar.
No recomendado Haz clic sobre Guardar. · Clickea Guardar.
«haz clic aquí»: No se usa. El texto del enlace describe el destino (Referencias cruzadas y enlaces).
cliente: En documentación de API REST o RPC, «cliente» abrevia «app cliente»: la app que escribe quien desarrolla. No lo uses como abreviatura de «librería cliente»: para eso di «librería». En cis-admin, «cliente» es además la contraparte comercial; si hay riesgo de confusión, distingue «app cliente» y «cliente (empresa)».
cochid-datos, lago de datos: «Datos» a secas es ambiguo en la casa. Di «cochid-datos» para el repositorio y el servicio, y «el lago de datos» para la base analítica. Los esquemas van en fuente de código: gold, silver.
código, base de código: Codebase se traduce «base de código» o simplemente «el código». El lugar donde vive es «el repositorio»; escribe «repositorio» completo en documentación (ver repositorio).
como: Tres usos que conviene separar. Comparación o ejemplo: «motores como Postgres» (bien). Causa: solo al inicio de la oración y sin ambigüedad («Como no hay ventas, el F29 acumula remanente»); en medio de la oración usa «porque». No lo uses con el sentido temporal del as inglés: «mientras se ejecuta», no «como se ejecuta».
compatible, admite: Para supports: «cis-verify admite PDF y Markdown» o «es compatible con». No uses «soporta» (ver Anglicismos).
completar, llenar: «Completa el formulario» para el formulario entero; «llena los campos obligatorios» para campos individuales.
config: Escribe «configuración» en prosa. config solo como nombre literal de un archivo, un objeto o un comando.
consola, panel: No digas «la consola» ni «el panel» a secas: nombra la herramienta (cis-admin, cis-mando, el validador de documentos). Tras la primera mención completa puedes acortar («el panel»). Para las subpáginas usa «página», no «pestaña». «La consola del navegador» sí es un término completo. Si no existe término específico, di «interfaz web».
consultar, ver: Para remitir a enlaces y referencias cruzadas: «consulta» dentro de la oración («Para más información, consulta Respaldos») y «ver» en remisiones cortas entre paréntesis («(ver Tablas)»). Nunca «mira», «chequea» ni «revisa» para remitir. El lenguaje de la vista («ver», «consulta») es válido para todo lector (Accesibilidad).
contraseña: El término de la casa para password. No uses «password» ni «clave» (ambigua con las claves criptográficas y de API).
Control+C y otros atajos de teclado: Escribe el nombre de la tecla y el signo más sin espacios: «Control+C», «Mayús+F5». En macOS es «Comando» y «Opción»: si tu audiencia mezcla sistemas, menciona ambos: «Presiona Control+C (Comando+C en macOS)». Las teclas llevan su nombre en español: «Intro», «Mayús», «Supr», «Esc». No uses «Ctl-S», «Cmd-S» ni «Enter».
copiar y pegar: Evita la instrucción «copia y pega»: di qué ingresar, no cómo.
Recomendado En el campo Consulta, ingresa el resultado del paso anterior.
No recomendado Copia el resultado del paso anterior y pégalo en el campo Consulta.
correo: «Correo» o «correo electrónico»; no «email», «e-mail» ni «mail» en prosa (el servicio de infraestructura del grupo llamado «mail» se cita como nombre propio). No lo uses como verbo: «envía un correo». La casilla canónica de cada sistema se nombra completa la primera vez.
CPU: En mayúsculas, sin desarrollar: la sigla es más conocida que su forma larga. «La CPU»; plural invariable: «las CPU».
«crear un nuevo…»: Escribe «crea un proyecto», no «crea un nuevo proyecto», salvo que necesites distinguirlo de otro recién creado. Todo lo que se crea es nuevo.
cuenta: Di de qué sistema: «tu cuenta de cis-auth». En contabilidad, «cuenta» es además una cuenta del plan de cuentas; si el documento toca ambos mundos, desambigua siempre.
curl: En minúscula: curl. No «cURL».

D

datos: Plural siempre: «los datos son», «menos datos». «Dato» en singular es un valor concreto. No uses «la data» (anglicismo frecuente en Chile). «Data» sobrevive solo dentro de nombres propios y de código.
Recomendado Los datos del padrón están completos.
No recomendado La data del padrón está completa.
centro de datos: Tres palabras: «centro de datos», no «datacenter». Análogos: «fuente de datos», «tipo de datos», «flujo de datos», «conjunto de datos» (dataset), «almacén de datos» (warehouse).
datos personales, datos sensibles: Para lo que el inglés llama PII, la casa usa «datos personales», el término de la Ley N.º 19.628 y de la Ley N.º 21.719. «Datos sensibles» es la subcategoría legal (salud, biometría, origen). «Confidencial» describe datos protegidos contra acceso no autorizado; «sensible», datos cuya difusión causa daño. Usa «PII» solo al citar un documento que lo use.
debe, debes: Para una obligación o un requisito: «debes tener el rol admin». En modo estricto de la norma, «debe/deben + infinitivo» es una de las tres perífrasis admitidas (P28); «tiene que» y «hay que» no lo son. Ver también puede, debería.
debería: Evítalo: es ambiguo por definición (¿recomendación?, ¿obligación?, ¿expectativa?). Di «debe» si es requisito, «te recomendamos» si es consejo, o el hecho («el proceso tarda 30 minutos») si es expectativa. «Debería funcionar» está además en la lista de señales de trabajo no verificado: verifica y afirma. Ver Documentación prescriptiva.
depurar: El verbo para debug. No «debuguear». El programa es «el depurador».
desde: Temporal o espacial: «desde marzo», «desde el navegador». No lo uses con valor causal calcado del since inglés: para la causa, «porque», «ya que», «dado que». Y en rangos, cierra siempre: «desde el 1 hasta el 15 de marzo», no «desde el 1 de marzo» si hay fin conocido.
desmarcar: Para quitar la marca de una casilla: «desmarca la casilla Borrador». No uses «deselecciona», «deschequea» ni «destilda». Ver marcar.
desplegar, despliegue: En la casa, desplegar es poner en producción (deploy): «despliega cis-verify con deploy-cis». No lo uses con el sentido de mostrar en pantalla: para eso, «se muestra», «aparece», «se abre». La confusión es frecuente en Chile y deja frases con dos lecturas («el panel se despliega»).
Recomendado Aparece el diálogo Confirmar asiento.
No recomendado Se despliega el diálogo Confirmar asiento.
diálogo: El elemento de UI que aparece delante de la ventana y pide o presenta información. La casa usa «diálogo»; no «pop-up», «ventana emergente», «modal» ni «cuadro de diálogo» en prosa. «Diálogo» con su otro sentido queda para conversaciones entre personas. Ver Elementos de UI.
directorio, carpeta: Si la herramienta que documentas usa uno de los dos, síguela. Si no: «directorio» en contextos de línea de comandos, «carpeta» en interfaces gráficas. En caso de duda, «directorio».
deshabilitar, deshabilitado: No lo uses para describir algo roto. Para estados de UI, usa el término preciso: «inactivo», «no disponible», «desactivado». Para acciones: «deshabilita» (funciones, API) o «desactiva» (opciones, interruptores), y el mismo verbo en todo el documento. Ver habilitar.
DTE: «Documento tributario electrónico (DTE)» en la primera mención; después, «el DTE». Plural invariable: «los DTE», nunca «los DTEs» (Plurales). Los tipos van con su número oficial: «factura electrónica (DTE 33)».
documento, documentación: Para el texto que explica un producto o servicio, di «este documento», no «este artículo», «este post» ni «esta nota». Aceptable «este tutorial» o «este manual» para esos tipos concretos. «Documentación» se escribe completa; no «docs» en prosa (los subdominios docs.* son nombres). Y no anuncies el documento dentro del documento: «el presente informe» es meta-discurso (P15).

E

EE. UU.: La abreviatura de Estados Unidos: duplicada, con puntos y con espacio. No «EEUU», «USA» ni «U.S.». Ver América.
ejecutar: El verbo de la casa para run y execute: «ejecuta el script», «la consulta se ejecuta cada noche». «Correr» es coloquial y queda para el canal interno; «lanzar» sirve para iniciar un trabajo largo; «invocar», para funciones. Elige uno por documento y mantenlo (P07).
elegir: Para decisiones genéricas («elige un período»). Para elementos de UI concretos, usa «selecciona». No «escoge» y «elige» mezclados en el mismo documento.
elemento, etiqueta: En HTML y XML, la etiqueta (<i>) marca el inicio o el fin de un elemento. No llames «etiqueta» al elemento entero. Ver HTML y etiquetado semántico.
emoji: Plural «emojis». En prosa formal no se usan: la norma los marca (P19).
endpoint: Préstamo aceptado, masculino: «el endpoint», «los endpoints». Una palabra, sin guion.
entonces: En condicionales, la condición va primero y «entonces» es opcional: «Si el healthcheck falla, el deploy se revierte». No lo uses como muletilla narrativa de arranque («Entonces, ahora abrimos…»).
es posible que, puede que: Para resultados incompletos o inciertos: «es posible que el sistema te pida las credenciales de nuevo». Un matiz por oración: no apiles «quizás podría ser posible que» (P10). Ver puede.
escribir, ingresar: «Escribe» o «ingresa» un valor en un campo; si importa no presionar Intro, dilo. No uses «tipear» ni «digitar».
Recomendado En el campo Glosa, escribe Aporte socio.
No recomendado Tipea la glosa. · Digita la glosa.
etc.: Evita «etc.», «y así sucesivamente» y «entre otros» cuando puedas: introduce la lista con «como» o «por ejemplo», que ya avisan que no es exhaustiva, y no cierres esas listas con «etc.» (es redundante). Si de verdad lo necesitas, «etc.» lleva punto, y nunca lo combines con puntos suspensivos.
Recomendado La app puede fallar por inestabilidad o latencia alta, por ejemplo.
No recomendado La app puede fallar por inestabilidad, latencia alta, etc.
signos de exclamación: En general, evítalos: la documentación informa, no celebra. Si usas uno, el signo de apertura «¡» es obligatorio en español. Nunca más de un par por página, y jamás en mensajes de error.
explotar: Solo en sentido negativo: «explotar una vulnerabilidad». Para «sacar provecho», usa «usar» o «aprovechar».
extraer: Para archivos comprimidos: «extrae el archivo», no «descomprime», «desempaqueta», «untar» ni «unzip». Los comandos van en fuente de código: tar, unzip.

F

fácil, fácilmente, simple, simplemente: Lo que es fácil para ti puede no serlo para quien lee. Elimina la palabra: la oración casi siempre dice lo mismo sin ella. Igual con «rápido» y «rápidamente» cuando no hay cifra; si hay dato, muéstralo («el build tarda 40 segundos»).
fechas: Formato de la casa: «20-08-2026» o «20 de agosto de 2026». En nombres de archivo y en código, ISO: 2026-08-20. Nunca el orden inglés 08/20/2026. Los meses van en minúscula. Detalle en Fechas y horas.
feriados: No ubiques eventos con «los feriados», «las fiestas» o «el 18»: los feriados de Chile no son globales y la referencia envejece. Di el mes o el trimestre: «la mantención se programa para septiembre».
firewall: Préstamo aceptado, masculino: «el firewall». Si prefieres «cortafuegos», mantenlo en todo el documento (P07). En documentación de redes del grupo, las reglas concretas son «reglas de firewall» (iptables se cita en fuente de código).
flecha de expansión: El control que expande o contrae una sección. Usa «flecha de expansión» y «sección expandible»; no «zippy», «expando» ni «triángulo».
foo, bar, baz: Evítalos aunque sean comunes: usa marcadores con significado. En los ejemplos de la casa: ASIENTO_ID, RUT_EMPRESA, mi-servicio. Ver Formato de marcadores de posición.
funcionalidad: Con cautela: designa un conjunto de funciones y cómo operan juntas. Si quieres decir «funciones» o «capacidades», di eso. No «funcionalidades» como plural comodín.

G

género gramatical: Reformula alrededor del género: «la persona que administra», «quien firma», segunda persona o infinitivo. No uses «él/ella», «el/la», «(a)», la arroba, la equis ni la «e» como marca («usuari@s», «usuarixs», «usuaries»): rompen lectores de pantalla, búsqueda y traducción. Cuando no hay colectivo, el masculino genérico es aceptable. Detalle y ejemplos en Lenguaje inclusivo.
googlear: No lo uses en documentación: «busca en Google» o, mejor, da el enlace exacto.
guion en compuestos asentados: La regla general de guiones está en Guion; esta lista registra las formas asentadas que la contradicen y ganan: con guion, «horas-persona», «relación padre-hijo», «despliegue azul-verde», «little-endian» y «big-endian», «relación calidad-precio»; con espacio y sin guion, «post mortem» y «ad hoc»; en una sola palabra, los prefijos productivos («autoescalado», «multirregión», «preexistente», «subcomando»).
gurú, ninja, rockstar, sherpa: No los uses para personas: di «experto», «especialista», «guía». Aceptables solo dentro de nombres propios de herramientas o empresas.

H

habilitar: Para activar una función o una API: «habilita la API antes de crear la clave». Para opciones e interruptores de UI, «activa». No lo uses con persona como objeto: para lets you, di «te permite».
Recomendado La API te permite detectar duplicados.
No recomendado La API te habilita para detectar duplicados.
hardcodear, hardcodeado: No se usan. Di «fijo en el código» o «escrito directo en el código»: «el umbral está fijo en el código; muévelo a la configuración».
hash: Préstamo aceptado, masculino: «el hash». La casa publica verificaciones con SHA-256 (con guion): «el SHA-256 del PDF». No «sha256» en prosa; en código, la grafía literal.
healthcheck, comprobación de estado: En documentación de infraestructura, «healthcheck» es préstamo aceptado (el endpoint /health se cita en código). Para lectores no técnicos, «comprobación de estado». No digas que un servicio está «sano» o «saludable»: di que «responde» o «no responde». Y recuerda la lección de la casa: que Caddy conteste /health no prueba que la app viva; sonda el endpoint real.
hito: Aceptable para fechas comprometidas de un plan. No «milestone» en prosa; milestone solo citando la herramienta.
horas: Formato de 24 horas: «14:30», «9:05». Con zona cuando el dato cruza husos: «14:30 (hora de Santiago, UTC-4)». En código y logs, ISO 8601: 2026-08-20T14:30:00-04:00. Ver Fechas y horas.
HTTPS: Todo en mayúsculas. No «HTTPs» ni «https» en prosa; en URL y código, minúscula literal.

I

IA: La sigla se entiende sola; no hace falta desarrollar «inteligencia artificial», salvo audiencia no técnica. «IA generativa» completo, no «GenAI». «Modelo de lenguaje (LLM)» en la primera mención; después, «el modelo». No escribas «AI». Y no la vuelvas sujeto de todo: ver agente y Antropomorfismo.
ID: Mayúsculas: «ID», no «Id» ni «id», salvo literales de código. Masculino: «el ID del asiento». Si la audiencia lo agradece, escribe «identificador».
imagen: Ambigua sola: di «imagen de disco», «imagen de contenedor» o, si es una figura, «figura». Ver Figuras e imágenes.
impactar, impacto: Prefiere «afectar»: «este problema afecta el cierre mensual». «Impacto» como sustantivo es aceptable; «impactar en» es calco y no se usa. Mejor todavía: di el efecto con dato («suma 40 ms por petición»).
ingesta, ingestar: «Ingesta» es aceptable en ETL cuando la carga incluye procesamiento significativo; para el movimiento simple de datos di «importar», «cargar» o «copiar». El verbo «ingestar» no existe: usa «cargar».
interfaz: Con zeta, plural «interfaces». Solo sustantivo: no «interfacear»; para el verbo, «interactuar con», «comunicarse con». «Interfaz de usuario» desarrollado en la primera mención si la audiencia lo necesita; no uses «la UI» para referirte a una página concreta (ver consola).
internet: En minúscula. Sin artículo o con artículo femenino, pero consistente en el documento.
E/S (entrada/salida): Desarrolla «entrada/salida (E/S)» en la primera mención. «I/O» solo dentro de nombres propios o citas de documentación externa.
IoT: «Internet de las cosas (IoT)» en la primera mención. La o va en minúscula.

K

k8s: No se usa: escribe «Kubernetes».

L

lenguaje figurado: Los términos gráficos o metafóricos del inglés técnico no se calcan: no «radio de explosión» (di «área afectada»), no «se cuelga» (di «deja de responder»), no «matar el servidor» fuera de kill, no «STONITH» sin explicar la operación. La norma bloquea además las metáforas gastadas del español (P22). Detalle en Lenguaje inclusivo.
heredado (legacy): Si puedes, usa un término más preciso o da la versión. Si usas «heredado» o citas «legacy», define qué significa en tu contexto y no lo uses como descalificación.
leyes y normas: Formato de la casa: «Ley N.º 19.799», con N.º y punto de miles. La primera mención puede llevar la materia: «Ley N.º 19.799, sobre documentos electrónicos y firma electrónica». Los artículos: «artículo 5» (no «art. 5.º» en prosa).
librería: La forma de la casa para library de software: «las librerías compartidas», «librería cliente». El grupo eligió «librería» sobre «biblioteca»; no las alternes (P07).
límite, cuota: Di qué límite: «límite de uso», «límite de peticiones por segundo», «límite de tamaño». «Cuota» solo si la herramienta lo llama así.
log: Préstamo aceptado en infraestructura: «el log», «los logs», «el journal de systemd» citando la herramienta. En documentos para lectores no técnicos, «el registro». Recuerda la pauta de frescura de la casa: al citar un log, di el timestamp y la fuente.

M

mantener presionado

En pantallas táctiles: «mantén presionado el elemento». No «long press» ni «toca y sostén».

mantener el puntero sobre

Úsalo solo cuando el lector debe esperar a que la UI reaccione (aparece la ayuda, se abre un submenú): «mantén el puntero sobre el ícono para ver el nombre». Si basta con dirigir el mouse, usa «apunta a». No «hover», «hoverea» ni «pasa el mouse por encima».

manual de operación

El término de la casa para runbook: el documento paso a paso para operar un sistema. Se escribe en modo estricto de la norma de prosa (P25..P32, órdenes en infinitivo). «Runbook» solo citando herramientas que usen la palabra.

marcar

Para casillas: «marca la casilla Borrador». No «chequea», «tilda» ni «selecciona» (reservado para listas y texto). El contrario es «desmarca».

Recomendado Marca Buscar actualizaciones automáticamente.

No recomendado Chequea Buscar actualizaciones automáticamente.

Markdown

Siempre con mayúscula inicial, incluso para variantes no estándar.

más de un, uno o más

«Más de un» concuerda en singular («más de una instancia a la vez»); después de «uno o más», plural. Detalle en Plurales.

mouse

La forma de la casa (uso americano): «el mouse», «el puntero del mouse». No «ratón». Los verbos asociados: «apunta a», «haz clic», «arrastra».

maestro y esclavo (master, slave)

No se usan, ni juntos ni por separado. Reemplazos según el dominio:

Replicación de bases de datos: «primario» y «réplica».
Procesos coordinados: «controlador» y «trabajador», «líder» y «seguidor».
Claves: «clave primaria» (bases de datos), «clave raíz» (seguridad).
Git: la rama se llama main; cítala por su nombre literal.

Si el código usa la palabra literal, cítala una vez en fuente de código, aclara el referente y sigue con el término nuevo: «el proceso secundario (slave)».

Recomendado Postgres primario con dos réplicas.

No recomendado Postgres master con dos slaves.

mientras

«Mientras» es temporal: «mientras corre el respaldo, no reinicies el servicio». Para el contraste usa «aunque» o «mientras que»: «aunque el poller recibe el DTE, el acuse lo emite el gateway». No uses «mientras» solo con valor de contraste: queda ambiguo.

microservicios

Una palabra, minúscula: «microservicios».

método

En contextos de programación donde «método» es un miembro de una clase, no lo uses a la vez con el sentido de «manera»: para eso, «forma», «procedimiento», «enfoque».

moneda

Pesos chilenos: «$6.232» con punto de miles; «CLP» en tablas y datos. Si el documento cruza monedas, marca todas: «CLP 6.232», «USD 100». La UF con coma decimal: «UF 39,5». No mezcles el punto decimal inglés en cifras en español (Números).

N

no aplica: En tablas, «n/a»; en la primera aparición o en prosa, «no aplica» o «no disponible», según lo que signifique. No «N/A» a secas si la tabla llega a lectores no técnicos.
nativo: No lo uses para personas. Para software, di «integrado» o «incorporado»: «nativo de la nube» admite tres lecturas distintas. «Hablante nativo» se reformula: ver Lenguaje inclusivo.
ni… ni: «Ni A ni B», no «ni A o B». Con más de dos elementos, repite «ni» ante cada uno.
no (prefijo negativo): Separado y sin guion: «términos no inclusivos», «la no respuesta del servicio». Cuando existe la palabra con prefijo, prefiérela: «inactivo», «deshabilitado», «incompatible».
nombres de servicios del grupo: Los servicios se escriben en minúscula y con guion, tal como su repositorio: cis-admin, cis-verify, cis-mailer, cochid-datos, vps-cis. Nunca «Cis-Admin» ni «CIS Admin». A inicio de oración conservan la minúscula; si molesta, reordena la frase. Detalle en Nombres de producto del grupo.
nosotros: No uses «nosotros» ni «hagamos» para acompañar al lector en una tarea: el que actúa es «tú». Aceptable cuando el antecedente es la organización: «En la Compañía operamos los tres dominios». Ver Segunda persona.
nube: En minúscula: «la nube», «nube híbrida». El grupo no usa nube pública para sus servicios en producción: describe la infraestructura real (vps-cis, vps-dev) en vez de «la nube» genérica.

O

OAuth 2.0, OIDC: «OAuth 2.0», no «OAuth2» ni «Oauth». El protocolo de cis-auth es «OpenID Connect (OIDC)» en la primera mención; «OIDC» después.
o bien… o bien: Con alternativas excluyentes, mantén la sintaxis paralela: «o ejecutas la opción 1 o ejecutas la opción 2». En general, reserva la disyuntiva explícita para dos opciones.
obsoleto: Cuando algo se desaconseja y va a dejar de estar disponible, quedó «obsoleto». No uses el calco «deprecado». Obsoleto no significa eliminado: si ya no existe, di «se eliminó». Di siempre el reemplazo y, si aplica, la versión: «q_exec quedó obsoleto en la 2.3; usa q_run».
sin conexión, en línea: «En línea» y «sin conexión»; no «online» ni «offline» en prosa. «Estar en línea» (conectado) no es lo mismo que «poner en línea» (publicar): si hay ambigüedad, reformula («publicar», «desplegar»).
de fábrica, listo para usar: Para software: «de fábrica», «sin configuración adicional», «estándar». No uses la metáfora «fuera de la caja» ni «pensar fuera de la caja».

P

página: Una página web completa, o una subpágina de cis-admin y de los paneles del grupo: «Ve a la página Asientos». Para recargar: «Para actualizar la página, presiona F5».
parámetro, argumento, opción: En documentación de API, «parámetro» suele ser el parámetro de consulta NOMBRE=VALOR de la URL. En línea de comandos, la casa distingue «opción» (lo que no es el comando: --fuerza) y «argumento» (el valor que recibe). «Flag» solo citando documentación ajena. Ver Sintaxis de línea de comandos.
pestaña: Para las pestañas del navegador. Las subpáginas de un panel son «páginas», no «pestañas». No fuerces enlaces a abrirse en pestaña nueva (Enlaces).
PII: Ver datos personales.
pipeline: Préstamo aceptado, masculino: «el pipeline de ingesta». Si el documento es para lectores no técnicos, «la cadena de procesamiento».
plugin: Sustantivo, sin guion: «el plugin», «los plugins». El verbo es «conectar» o «instalar el plugin». Para audiencias de usuario final puedes decir «complemento»; no alternes ambos en un documento (P07).
poblar: Aceptable para procesos que llenan una tabla: «el script puebla la tabla con datos de muestra». Para personas, «completa»: «cuando termines de completar el formulario».
podría: Evítalo: casi siempre «puede» dice lo mismo con menos vaguedad, y el condicional apilado dispara el hedging (P10). «El proceso podría tardar» es «el proceso puede tardar». En modo estricto, el condicional está fuera de la lista de formas admitidas (P32). Ver puede.
por ejemplo: Con coma después. Separa el ejemplo con paréntesis, comas o una oración aparte; nunca con raya (P05). La abreviatura «p. ej.» (con espacio) solo donde falta sitio: tablas, notas.
Recomendado Ingresa un nombre para la instancia (por ejemplo, mi-instancia-99).
No recomendado Ingresa un nombre para la instancia —por ejemplo, mi-instancia-99.
por favor: No se usa en instrucciones, ni siquiera en tareas difíciles; tampoco «ten en cuenta que» como relleno. Resérvalo para pedir algo que te beneficia a ti o incomoda al lector: «Si el problema persiste, por favor escríbenos».
posible, imposible: No los uses por «puedes» o «no puedes». «No es posible anular un asiento aprobado» esconde al agente: «no puedes anular un asiento aprobado» o «cis-admin no permite anular asientos aprobados».
Postgres: La forma de la casa en prosa: «Postgres». «PostgreSQL» queda para citas formales y nombres de paquete. Los objetos, en fuente de código: pg_dump, gold.mundial_forecast.
post mortem, retrospectiva: Para el análisis de un incidente: «post mortem sin culpas» (dos palabras, sin guion). Para revisiones generales de un proyecto, «retrospectiva».
presionar: Para teclas y botones físicos: «presiona Intro», «presiona Control+C». No «apreta», «pulsa», «dale a» ni «hit». Para botones en pantalla, «haz clic» o «toca».
primitivo: Con cautela y nunca como descalificación. En programación, «tipo primitivo» es correcto.
profesionales (practitioners): No digas «profesionales del área» sin definir los roles: nombra a quiénes te refieres («contadores, desarrolladores, administradores»).
puede, puedes: Para permiso, capacidad, acción opcional o resultado posible: «puedes ver los logs con jcu», «el proceso puede tardar 30 minutos». Es el modal por defecto de la casa; «podría» se evita (usa «puede»), y el futuro «podrá» solo en texto legal. En modo estricto, «puede/pueden + infinitivo» es perífrasis admitida (P28). Ver debe y es posible que.
puerto: «El servicio escucha en el puerto 8267», no «escucha al puerto».

R

repositorio: Completo en documentación: «el repositorio cochid-datos». «Repo» queda para el canal interno y los mensajes de commit.
respaldo: El término de la casa para backup: «el respaldo corre a las 3:30», «respaldar el lago de datos». No «backup» ni «copia de seguridad» (P07). Y al documentar respaldos, mide bytes, no archivos: un respaldo de 13 bytes no es un respaldo.
REST: No desarrolles la sigla: para quien no la conoce, la forma larga no ayuda. «Una API REST».
revisar: Si quieres decir «leer por primera vez», di «lee». «Revisar» queda para la lectura crítica: «revisión de código», «revisa el diff antes de desplegar».
RFC: Con espacio antes del número: «RFC 2318».
despliegue gradual: Para lanzamientos por etapas: «despliegue gradual», «por fases». No uses «roll out» como sinónimo de lanzamiento instantáneo; si lo citas, define qué significa en tu contexto.
RUT: Mayúsculas, con puntos de miles y guion antes del dígito verificador: «RUT 78.384.591-1». En datos y código, sin puntos si el esquema lo exige, y documenta el formato. Para personas naturales en documentos formales, la casa escribe «cédula nacional de identidad N.º …».

S

comprobación rápida (sanity check): No uses «sanity check» ni «chequeo de cordura»: di «comprobación rápida», «comprobación de coherencia» o «verificación preliminar». Tampoco «sano», «demente» o «loco» para sistemas: «válido», «coherente», «inesperado» (Lenguaje inclusivo).
captura de pantalla: «Captura de pantalla»; el verbo es «toma una captura». No «pantallazo» (coloquial) ni «screenshot» en prosa.
escalar: Di la dirección y la magnitud: «escala horizontalmente agregando réplicas», «reduce la máquina a 2 CPU». No «el sistema escala» a secas. Para incidentes, «escalar un incidente» (derivarlo a otro nivel) es aceptable y distinto: desambigua por contexto.
seleccionar: Para elegir un elemento entre varios, seleccionar texto o elegir en una lista: «selecciona Borrador». Para casillas, «marca». Ver marcar y elegir.
servicio: Aceptable para las unidades de systemd y para los productos del grupo. Si «servicios» queda ambiguo (¿unidad?, ¿producto?, ¿prestación a una relacionada?), nombra el servicio concreto.
acuerdo de nivel de servicio: En minúscula el término general; «SLA», «SLI» y «SLO» después de la primera mención desarrollada. Mayúsculas solo en el título de un documento específico.
si… (condicionales): La condición va primero, el resultado después: «Si el build falla, el deploy no parte». Incluye la consecuencia explícita; no dejes el «si» colgado. «Si» también reemplaza a «en caso de que» en prosa normal (P13).
SII: «Servicio de Impuestos Internos (SII)» en la primera mención de documentos para afuera; en documentación interna, «SII» directo. «Ante el SII», no «en el SII» para trámites.
sistema operativo (SO): Desarrollado en la primera mención; «SO» después. Plural invariable: «los SO». No «OS».
sobrescribir: Con una sola «e»: «sobrescribir», no «sobreescribir». Distingue «sobrescribir» (pisar un valor) de «anular» (dejar sin efecto; override se traduce según el caso).
solo: Sin tilde, también cuando significa «solamente» (la casa sigue la regla general de la RAE). Y casi siempre sobra: pruébala fuera de la oración. Si el matiz importa, «únicamente» o reordena.
Recomendado cochid-datos omite la fila.
No recomendado cochid-datos simplemente omite la fila.
SpA: Tal cual: «SpA», sin puntos. «Compañía de Innovación de Santiago SpA». No «S.p.A.» (eso es otra figura, italiana). No confundas con «SPA» (aplicación de una sola página); si el documento usa ambos, desarrolla el segundo: «aplicación de una sola página (SPA)».
SSH, ssh: SSH es el protocolo; ssh, el comando. Ninguno es verbo: «conéctate por SSH», «usa ssh para entrar»; nunca «sshea» ni «sshear».
startup: Para empresas: «startup» es préstamo aceptado, femenino («la startup»). Para el arranque de un sistema: «el inicio», «el arranque», no «el startup».

T

terceros: «De terceros» como adjetivo («librerías de terceros»), «un tercero» como sustantivo. No «3ros» ni «third parties» en prosa. Ver Contenido de terceros.
terminar: En español, «terminar» es el verbo llano para acabar algo y se usa sin problema: «cuando termina la migración». Lo que se evita es el terminate figurado del inglés para matar procesos: ahí usa «detener», «salir» o «cancelar», y cita kill o SIGTERM en fuente de código cuando corresponde. En telefonía y redes, «terminar» tiene sentido técnico propio y es válido.
tiempo de espera: Para timeout en prosa: «se agotó el tiempo de espera». timeout en código y configuraciones. Da el valor: «el tiempo de espera es de 30 s».
tildes y eñes: Siempre, sin excepción: en prosa, en UI, en mails, en mensajes de error y en comentarios de código. También en mayúsculas: «MÁS», «ANÓTESE». El transporte es UTF-8 de punta a punta; si una capa rompe los acentos, se arregla la capa, no se escribe sin tildes.
tocar: El verbo para pantallas táctiles: «toca Enviar». No «tap», «tapea», «pincha» ni «presiona» (reservado para teclas y botones físicos). Ver Elementos de UI.
tú, usted: La casa trata al lector de «tú», en presente y voz activa, y jamás con voseo verbal («imprimí», «podés»: P06). «Usted» y las fórmulas de cortesía quedan para documentos formales con terceros (cartas, actas, sobres), donde manda la plantilla del documento. Ver Segunda persona.

U

una vez: Ambigua: significa «una sola vez» y también «después de». Para la secuencia temporal usa «después de», «cuando» o «una vez que» completo («una vez que el build termina»); la construcción «una vez + participio» («una vez instalado») también es clara. Para la frecuencia, di «una sola vez».
Recomendado Después de aprobar el asiento, genera el comprobante.
No recomendado Una vez aprobado genera el comprobante una vez.
Unicode, UTF-8: «Unicode» con mayúscula inicial; las codificaciones con guion: «UTF-8», «UTF-16».
tipo Unix, tiempo Unix: «Sistemas tipo Unix». «Tiempo Unix» es el número de segundos desde el 1 de enero de 1970 a las 00:00:00 UTC; defínelo si tu audiencia puede no conocerlo.
usuario: Reserva «usuario» para quien usa el software que tu lector construye u opera. Al lector háblale de «tú»: «puedes configurar el umbral», no «el usuario puede configurar el umbral». «Nombre de usuario» para username; no «nombre de cuenta».
utilizar: Prefiere «usar»: nunca una palabra larga donde sirve una corta. «Utilización» es aceptable como métrica de recursos: «la utilización de CPU supera el 75 %».

V

ve a: El verbo para moverse por una interfaz o un documento: «ve a la página Asientos», «ve a la sección Respaldos». No «navega a», «dirígete a» ni «scrollea hasta»; el desplazamiento es un detalle de implementación (Accesibilidad).
versión, v: «Versión 1.4» en prosa; la abreviatura «v» en minúscula y pegada: «kit v9», «v1.4.2». Rangos: «la versión 2.2 o posterior», nunca «2.2+» ni «superior». La versión con número más alto no siempre es la última publicada: si una 2.0 recibe un parche después de salir la 3.0, la 2.0.1 puede ser la más reciente.
vía: Con tilde siempre. En prosa prefiere «por» o «mediante»: «se publica mediante publicar.sh». «Vía» es aceptable en notas y tablas por brevedad.
viceversa: Una sola palabra en español. Mejor aún: escribe la relación explícita en ambas direcciones, o usa «a la inversa».
Recomendado Puedes subir archivos locales al servidor o descargar los del servidor a tu equipo.
No recomendado Puedes copiar archivos locales al servidor y viceversa.
máquina virtual (VM): Desarrollada en la primera mención; «la VM» después. Los servidores del grupo son VPS: di «el servidor vps-cis», no «la VM» salvo que hables de virtualización.
frente a (versus): En prosa, «frente a» o «contra». «Vs.» solo en tablas y títulos comparativos donde falta espacio.

W

web: En minúscula: «la web», «el sitio web», «una página web». No «website» ni «World Wide Web». «Sitio» es el conjunto; «página», una unidad.
servidor web: Dos palabras. El del grupo es Caddy; nómbralo cuando la instrucción dependa de él.
wifi: En minúscula y sin guion: «la red wifi». No «Wi-Fi» salvo citando una marca o UI.

Z

zona horaria: Dos palabras. Chile continental alterna UTC-4 y UTC-3: cuando el dato cruce husos o venga de un log, di la zona («14:30, hora de Santiago, UTC-4»). Los servidores registran en su propia zona; verifica antes de comparar timestamps (el stat de vps-cis reporta -0400, no UTC).

Términos que no se usan

La tabla de consulta rápida: lo que está prohibido o se evita en toda la prosa del grupo, con su reemplazo y la regla que lo respalda. Las reglas P01..P37 son de la norma de prosa (core/prosa/NORMA.md); el hook de la casa bloquea las del tier «bloquea» al escribir. Las demás filas vienen de esta guía y de Lenguaje inclusivo. Si una fila te obliga a escribir algo peor, rompe la regla y déjalo anotado: prosa-ok: <razón>.

Muletillas y fórmulas huecas

Si es importante, dilo primero; no lo anuncies.

Recomendado Migramos los datos el 15 de agosto. Sin esa migración, el sistema pierde los respaldos automáticos.

No recomendado Es importante destacar que, en el marco del proceso de modernización, se procederá a realizar la migración de los datos.

No se usa	Usa	Regla
cabe destacar, cabe señalar, es importante señalar, vale la pena mencionar	elimina la frase y di el hecho	P01
en el marco de	«en», «dentro de», «durante»	P01
hoy en día, en la era digital, en el mundo actual	elimina; si importa la fecha, dila	P01
en aras de, es menester, por medio de la presente	«para», «hay que», elimina	P01
juega un papel, desempeña un rol, se erige como	di qué hace: «valida», «ordena», «bloquea»	P01
sin lugar a dudas	afirma directo	P01
en la actualidad, a nivel de, de cara a	elimina, «en», «para»	P18
en virtud de, a efectos de, bajo apercibimiento	«según», «para» (fuera de texto legal)	P13
el presente documento, a lo largo de este documento, como se mencionó, a continuación se detalla, en conclusión	el texto no habla de sí mismo: entra al contenido	P15
habiendo verificado, siendo que	«tras verificar», «porque»	P14
en base a	«con base en», «según», «a partir de»	casa
al interior de	«dentro de», «en»	casa
en relación a	«en relación con», «sobre»	casa
a la brevedad	di cuándo: fecha u hora concreta	casa
dicho archivo, la misma, el mismo (anafóricos)	«ese archivo», «esta», o repite el sustantivo	casa
los expertos señalan, estudios demuestran, es ampliamente considerado	cita la fuente con nombre o elimina la autoridad	P17

Retórica, marketing y metáforas

El adjetivo no reemplaza al dato. Si el producto es rápido, di la latencia; si el informe es sólido, muestra el perímetro y la cifra.

No se usa	Usa	Regla
no es solo X, es Y · más que un X, es un Y · es un testimonio de	afirma directo, sin antítesis	P02
de vanguardia, de clase mundial, de última generación, revolucionario, disruptivo, sin fricciones, seamless	el dato: cifra, fecha, latencia; o elimina el adjetivo	P04
performante	«eficiente», «rápido», o la métrica	P04
apalancar, sinergia	«usar», «aprovechar»; describe la colaboración real	casa
robusto, potente (sin dato)	qué aguanta y cuánto: «procesa 4 millones de filas en 14 s»	juicio
la punta del iceberg, tormenta perfecta, caja de Pandora, enfrenta desafíos, marcó un antes y un después, poner en valor, dejó una huella imborrable, sentó las bases	di el hecho sin la metáfora	P22
…, lo que refleja / demuestra / subraya	corta en la coma; si no se pierde un hecho, era opinión	P34
…, consolidando su posición como referente	punto y verbo conjugado; sin gerundio colgante	P33
espero que te sirva, ¿quieres que profundice?, excelente pregunta	nada: es residuo de chat, no prosa de documento	P35

Términos no inclusivos o figurados

Reemplaza el término o escribe alrededor de él; si está asentado en la industria y omitirlo confunde, cítalo una vez entre paréntesis y sigue con el reemplazo (Lenguaje inclusivo).

Recomendado Agrega la IP a la lista de permitidos (a veces llamada whitelist).

No recomendado Agrega la IP a la whitelist.

No se usa	Usa
blacklist, whitelist, graylist (y sus verbos)	lista de bloqueados, lista de permitidos, lista provisional; describe la acción
master, esclavo	primario/réplica, controlador/trabajador, líder/seguidor; `main` en Git
horas-hombre, hecho por el hombre	horas-persona; artificial, sintético
hombre en el medio (MITM)	ataque de intermediario
loco, demente, insano, de locos	complejo, extraño, inesperado (y solo para cosas)
ciego a, hacerse el ciego, a ciegas (escritura)	ignora, sin confirmar el valor; para personas: persona ciega, con baja visión
cojo, deja cojo al servicio	ralentiza, degrada
sanity check, sano, saludable (sistemas)	comprobación rápida; el servicio responde
gitano	el pueblo: romaní; en sentido figurado: reformula
gurú, ninja, rockstar, sherpa	experto, especialista, guía
abuelo (cláusula del abuelo, grandfathered)	exento, anterior al requisito
mascotas contra ganado	manual contra automatizado; persistente contra dinámico
conocimiento tribal	conocimiento no documentado del equipo
war room, sala de guerra	sala de crisis, equipo de respuesta a incidentes
black hat, white hat	ilegal, no ético; legal, ético
radio de explosión (blast radius)	área afectada, alcance del impacto
nuke, matar (figurado)	eliminar, detener; `kill` solo como comando
primera clase, ciudadano de primera clase	describe la capacidad concreta
guante blanco	premium, asistido
dumb down, bajarle el nivel	simplificar, quitar jerga
vudú, magia negra	no determinista, sin documentar
chicos, muchachos (colectivo)	todos, el equipo
los ancianos, la tercera edad	adultos mayores

Vagos, coloquiales o que envejecen

La documentación de la casa es atemporal: nada de palabras que caducan con la próxima versión (Documentación atemporal) ni de coloquialismos que no viajan (Audiencia global).

Recomendado cis-admin no emite notas de crédito.

No recomendado cis-admin todavía no emite notas de crédito, pero pronto lo hará.

No se usa	Usa
actualmente, a la fecha, al momento de escribir, por ahora	elimina; el presente ya lo dice el verbo
todavía no, aún no	«no»: no anuncies planes por omisión
pronto, próximamente, en el futuro, con el tiempo	elimina, o da la fecha comprometida
nuevo, más reciente, último (sin referencia)	número de versión o fecha
viejo, antiguo (versiones)	«anterior a la 1.17»
fácil, fácilmente, simple, simplemente, rápido (sin dato)	elimina, o la cifra
aka	«también llamado», paréntesis, «o»
e.g., i.e.	«por ejemplo», «es decir» («p. ej.» solo en tablas)
etc. al final de listas con «como»	nada: «como» ya avisa que la lista no es exhaustiva
tl;dr, RTFM, ymmv, voilà	«en resumen», «consulta la documentación», «los resultados pueden variar»
haz clic aquí	texto de enlace descriptivo
vamos a crear, hagamos clic	imperativo directo: «crea», «haz clic»
al tiro, cachar, fome, a la chilena, pantallazo, dale a	de inmediato, entender, captura de pantalla, haz clic
este, esta, eso (sin sustantivo)	«este valor», «esa tabla»: pon el sustantivo
desea, deseado	«quieres», «necesitas», «el valor que corresponde»

Construcciones que bloquea la norma

Estas formas las detiene el hook al escribir; no llegan a revisión.

No se usa	Usa	Regla
realizar un análisis, llevar a cabo la validación, proceder a instalar, hacer uso de, dar inicio a, tomar la decisión de, tiene la capacidad de	analizar, validar, instalar, usar, iniciar, decidir, puede	P03
la raya — en cualquier posición	«·», «y», «hasta», paréntesis, o punto y oración nueva	P05
voseo verbal: imprimí, podés, hacé, tenés	imprime, puedes, haz, tienes	P06
rotación de sinónimos para un mismo concepto	un significante, un significado: el término del glosario	P07
fue elaborado por X	X elaboró	P23
Títulos en Title Case: «Impacto de la Tecnología en la Salud»	mayúscula solo en la primera palabra y los nombres propios	P37
tiene que verificar, va a instalar, podrá instalar (modo estricto)	debe verificar, instala, puede instalar	P28
será, enviará, permitirá (futuro para funciones)	presente: envía, permite; y sin promesas (Funciones futuras)	P27/P28

Anglicismos y su forma en español

Esta sección no viene de Google: fija la política del grupo para los préstamos del inglés, a partir de la norma de prosa y del uso real de los repositorios de la casa. Cinco reglas la resumen:

Si existe la palabra en español, úsala (Orwell 5): respaldo, despliegue, contraseña, enlace. La rotación «respaldo… el backup… la copia» es el hábito número 1 del slop (P07).
Un concepto, un término. Cuando esta página acepta un préstamo, esa es la forma; cuando lo traduce, esa es la traducción. No alternes dentro de un documento.
El préstamo que se queda va sin cursiva y sin comillas, con género fijo y plural en «-s»: el commit, los commits; el token, los tokens (Plurales). La cursiva queda para la palabra citada como palabra (Cursivas en términos).
Nada de verbos spanglish en «-ear»: ni deployar, ni mergear, ni testear. El verbo se traduce aunque el sustantivo se quede: «haz commit», «fusiona la rama».
El nombre literal manda en el código. Comandos, archivos y objetos se citan tal cual y en fuente de código: deploy-cis, cis-build, releases/<sha>, aunque la prosa alrededor diga «desplegar» o «compilación».

Se traducen siempre

Recomendado El respaldo del lago de datos corre a las 3:30 y el despliegue se verifica con una sonda.

No recomendado El backup del data lake corre a las 3:30 AM y el deploy se chequea con un healthcheck.

Inglés	Forma de la casa	Nota
backup	respaldo, respaldar	no «copia de seguridad» (P07)
deploy	desplegar, despliegue	`deploy-cis` literal en código
build (acción)	compilación, compilar	`cis-build` literal; «la build» solo citando el artefacto de una herramienta
release	versión, publicación	`releases/<sha>` literal en rutas
rollback	revertir, reversión
feature	función	«funcionalidad» con cautela (ver la entrada)
bug	error, defecto
issue	incidencia, ticket	«issue» solo citando GitHub
fix	corrección, arreglo
update / upgrade	actualización	si importa distinguir: «actualización de versión mayor»
link	enlace, enlazar
email	correo
password	contraseña
login / logout	inicio / cierre de sesión; iniciar sesión	«Salir» aceptable como etiqueta de UI
default	predeterminado, por defecto	elige una y mantenla
settings / setup	configuración
dashboard	panel	no «tablero»; nombra el panel concreto
checkbox	casilla
dropdown	lista, menú	«desplegable» solo si hay ambigüedad
toggle / switch	interruptor	el verbo es «activa» o «desactiva»
placeholder	marcador de posición
text box / field	campo
pop-up / modal	diálogo
tooltip	ayuda emergente
screenshot	captura de pantalla
data lake	lago de datos
dataset	conjunto de datos
query	consulta	`query` literal en parámetros
request / response	petición / respuesta	«solicitud» para trámites humanos
header (HTTP)	cabecera	`Content-Type` literal
payload	contenido, carga útil
timeout	tiempo de espera	`timeout` en configuraciones
timestamp	marca de tiempo	`timestamp` como tipo de datos
time zone	zona horaria
runbook	manual de operación	término de la casa
healthcheck	comprobación de estado	préstamo aceptado en infraestructura
load balancer	balanceador de carga
queue	cola
thread	hilo
string	cadena	`string` como tipo
array	arreglo	uso americano; no «matriz» para array
parse	analizar	«parsear» no se usa
merge	fusionar	`git merge` literal
branch	rama
performance	rendimiento
feedback	comentarios, observaciones
input / output	entrada / salida
path	ruta	en contextos de enrutamiento, desambigua: «ruta de archivo»
host name / filename / namespace	nombre de host / nombre de archivo / espacio de nombres	los literales, en código: `hostname`
whitepaper	informe técnico
wildcard	comodín
walkthrough	recorrido guiado, paso a paso

Se quedan en inglés

Préstamos que la audiencia técnica conoce por su nombre inglés. Van en redonda, con el género de la tabla y plural en «-s». Los que el español ya adaptó llevan su tilde: caché, clúster, estándar, búfer, escáner, píxel, máster.

Recomendado el commit, los tokens, el hash, la caché, los scripts

No recomendado el commit, los token, el hash o «resumen criptográfico», la cache

Término	Género y forma	Nota
backend, frontend	el backend, el frontend	una palabra, sin guion
commit	el commit, los commits	el verbo: «haz commit», «confirma los cambios»
token	el token
hash	el hash
script	el script
endpoint	el endpoint
pipeline	el pipeline
framework	el framework	si hay palabra mejor en tu contexto («marco de trabajo»), P07: una sola
kernel	el kernel
shell	la shell
socket	el socket
proxy	el proxy	«proxy inverso»
host	el host
runtime	el runtime	«en tiempo de ejecución» para el momento
log	el log, los logs	«registro» para lectores no técnicos
firewall	el firewall
plugin	el plugin
sprint	el sprint
pull request	el pull request	abreviatura «PR» tras la primera mención
prompt	el prompt
bot	el bot
cookie	la cookie
caché	la caché	adaptado, con tilde
clúster	el clúster	adaptado, con tilde
wifi	la red wifi	minúscula, sin guion
software, hardware	el software, el hardware	sin plural
librería	la librería	elección de la casa para library; no «biblioteca»
mouse	el mouse	no «ratón»

Calcos que no se usan

Falsos amigos y verbos inventados. El calco no es una traducción: es la palabra inglesa disfrazada, y casi siempre pisa a una palabra española que significa otra cosa.

Recomendado El poller quedó obsoleto en la 2.3; cis-admin admite el formato nuevo y suponemos que el certificado ya está instalado.

No recomendado El poller fue deprecado en la 2.3; cis-admin soporta el formato nuevo y asumimos que el certificado ya está instalado.

Calco	Usa	Por qué
deprecado	obsoleto	deprecar no significa eso en español
soportar (un formato)	admite, es compatible con	soportar es aguantar con esfuerzo
asumir (que algo es cierto)	suponer, dar por hecho	asumir es hacerse cargo
remover (un archivo)	quitar, eliminar	remover es agitar
aplicar (a un cargo)	postular	aplicar es poner sobre algo
eventualmente	con el tiempo, finalmente	en español significa «quizás»
accesar	acceder	no existe
la data	los datos	ver datos
tópico	tema	tópico es un lugar común
severo (un error)	grave	severo se dice de personas estrictas
comprensivo (un catálogo)	completo, integral	comprensivo es quien comprende
sensitivo (datos)	sensible
mandatorio	obligatorio
librería (de libros) y libraría	n/a	la acepción de software es la única aceptada como préstamo (ver arriba)
hacer sentido	tener sentido
en orden a	para
por instancia	por ejemplo	una instancia es otra cosa en esta casa
correr la última milla, ir la milla extra	terminar el trabajo; di qué falta	P22

Verbos spanglish: se traducen todos. «Clickear/cliquear» es haz clic; «tipear» y «digitar», escribe; «loguearse», inicia sesión; «setear», configura o establece; «customizar», personaliza; «testear», prueba; «debuguear», depura; «deployar», despliega; «buildear», compila; «mergear», fusiona; «commitear», haz commit; «pushear», sube; «crashear», falla o se cae; «bannear», bloquea; «randomizar», aleatoriza; «printear», imprime; «deletear», borra; «updatear», actualiza; «forwardear», reenvía; «attachear», adjunta; «hostear», aloja; «linkear», enlaza; «postear», publica; «rankear», clasifica; «surfacear», muestra o expone.

Resumen de formato de texto

Esta página condensa las convenciones de formato de texto que la guía desarrolla en otras secciones, adaptadas del resumen de Google a las reglas de la casa. Para la parte visual (figuras, tablas, listas), consulta Formato y organización.

Negrita

Usa negrita, <b> en HTML o ** en Markdown, solo para elementos de UI y para encabezados en línea, incluidos los que abren un aviso («Nota:», «Precaución:»). No la uses para dar énfasis a palabras sueltas: para eso está la cursiva, y casi siempre la frase puede cargar el énfasis sola.

En Markdown, el doble guion bajo __ también produce negrita, pero se confunde a simple vista en el editor: usa el doble asterisco.

Recomendado Haz clic en Guardar y revisa el resultado.

No recomendado Haz clic en Guardar y revisa el resultado.

Cursiva

Úsala con moderación, <i> o _, en estos casos:

Al presentar o definir un término, o al usar una palabra como palabra: «el término asiento viene de la partida doble». Detalle en Cursivas en términos.
Para los extranjerismos no aceptados como préstamo que necesitas citar una vez: «a veces llamada whitelist». Los préstamos aceptados van en redonda (Anglicismos).
Para énfasis semántico cuando de verdad hace falta: en HTML usa em; en Markdown, guiones bajos. Ni negrita ni subrayado para enfatizar.
Títulos de libros, películas y obras completas, salvo dentro de un enlace. Las obras cortas (artículos, capítulos de una serie) van entre comillas «», no en cursiva (Comillas).
Variables matemáticas y de versión: «x + y = 3», «versión 1.4.x». Los operadores no van en cursiva (Notación matemática).

Subrayado

Reservado para los enlaces. No subrayes texto que no enlaza: el lector va a intentar hacer clic.

Fuente de código

Usa <code> en HTML o el acento grave en Markdown para código en el texto: nombres de archivo, clases, métodos, comandos, códigos de estado HTTP, salidas de consola y marcadores de posición. Para bloques, <pre> o la valla de tres acentos graves. Detalle en Código en el texto.

Lo que el lector escribe pero no es código (texto para un campo de formulario) también va en fuente de código, con el elemento code, no kbd; kbd queda para teclas. No apliques estilos de fuente a mano ni redefinas los del kit.

Recomendado Ejecuta prosa-lint informe.md y revisa el score.

No recomendado Ejecuta prosa-lint informe.md y revisa el score.

Mayúsculas

Sigue la ortografía del español, no la inglesa: los meses, los días, los gentilicios y los nombres comunes van en minúscula. Títulos y encabezados en minúscula de oración: solo la primera palabra y los nombres propios llevan mayúscula (P37); nada de Title Case. Los marcadores de posición van en MAYÚSCULAS con guion bajo: ASIENTO_ID (Formato de marcadores de posición). Las mayúsculas conservan su tilde: «MÁS», «ANÓTESE». Detalle en Mayúsculas.

Recomendado Cómo verificar un documento firmado

No recomendado Cómo Verificar un Documento Firmado

Comillas

Las comillas de la casa son las angulares «», con las inglesas "" como nivel interior: «dijo "listo" y cerró». El punto va después de la comilla de cierre. Títulos de obras cortas entre comillas, salvo que sean parte de un enlace: el texto de un enlace no lleva comillas ni cursiva. Detalle en Comillas.

Tipo, tamaño y color de fuente

No redefinas los estilos globales del kit: ni tipo, ni tamaño, ni color. La tipografía del grupo es IBM Plex Sans con JetBrains Mono para código, self-hosted desde core-style; nunca Google Fonts ni system-ui como fuente de marca. Controla el estilo con HTML semántico o Markdown (code, em, b), no con estilos manuales. Si necesitas color, usa las variables del kit (var(--ink), var(--muted)), jamás un hexadecimal a mano. Detalle en HTML y etiquetado semántico.

Otras convenciones de puntuación

Nada de «&» como conjunción: escribe «y», también en títulos y navegación. La excepción es citar un elemento de UI que lo incluye (la entrada del glosario).
Cero rayas: ni para incisos ni para diálogos técnicos. Usa «·», paréntesis, comas o punto y oración nueva (P05, Rayas y guiones).
Signos dobles completos: toda pregunta abre con «¿» y toda exclamación con «¡». Las exclamaciones, casi nunca (la entrada del glosario).
Comillas y puntuación final fuera del texto del enlace (Enlaces).
Números al estilo chileno: miles con punto, decimales con coma («1.215.716», «0,4 %»); en código, el formato del lenguaje (Números).

La tabla de un vistazo

Elemento	Formato	Ejemplo
Elemento de UI	negrita	Haz clic en Guardar.
Encabezado en línea	negrita	Nota: el tóner al 0 % se ignora.
Término que se define	cursiva	Un asiento registra la partida doble.
Extranjerismo citado	cursiva	la lista de permitidos (whitelist)
Préstamo aceptado	redonda	el commit, los tokens
Título de obra completa	cursiva	El ingenioso hidalgo don Quijote de la Mancha
Título de obra corta	comillas «»	el capítulo «Plurales»
Comando, archivo, código	fuente de código	`vault list cis-admin`
Texto que ingresa el lector	fuente de código	Escribe `Aporte socio`.
Tecla	nombre en español	Presiona Intro.
Marcador de posición	mayúsculas, código	`RUT_EMPRESA`
Enlace	subrayado (lo pone el kit)	texto descriptivo
Énfasis	cursiva, con moderación	ese release no es un ancestro del checkout

Adaptación al español y a las convenciones del grupo de la Google developer documentation style guide, publicada bajo CC BY 4.0. Donde esta guía y la norma de prosa de la casa difieren, manda la norma (core/prosa/NORMA.md).