cis-style · hub

Puntuación

Diez signos y una regla de la casa que gana siempre: cero rayas (P05). Donde el español difiere del inglés, manda la ortografía del español: coma decimal y punto de miles, punto fuera de las comillas, sin coma antes de la «y» final de una serie, signos de apertura «¿» y «¡», comillas angulares en prosa. Donde la norma de prosa va más lejos que Google, la norma gana: el punto y coma desaparece en modo estricto (P31) y los puntos suspensivos no se usan para dar suspenso. Cada regla trae un par «Recomendado» y «No recomendado».

Resumen de lo que esta guía cambia respecto de la fuente en inglés:

Dos puntos

Los dos puntos anuncian que viene información estrechamente ligada a lo anterior: una lista, una explicación, una cita, un ejemplo.

Para el uso de dos puntos en listas de definición con título corrido, consulta Listas.

La frase que precede a los dos puntos

Cuando los dos puntos introducen una lista, el texto anterior debe poder sostenerse solo como oración completa. No cortes el verbo de su complemento con dos puntos.

Recomendado Los campos se definen así:
No recomendado Los campos son:
Recomendado El manual de operación cubre tres temas: usuarios, servicios y vault.
No recomendado El manual de operación cubre: usuarios, servicios y vault.

Dos puntos dentro de una oración

La primera palabra después de los dos puntos va en minúscula. Las excepciones están en Mayúsculas: una cita textual, el encabezado de una carta o un correo («Estimado equipo:») y un rótulo en línea propia («Nota:», «Ejemplo:») seguido de una oración completa.

Recomendado Tono: conciso, conversacional, cercano, respetuoso.
No recomendado Tono: Conciso, conversacional, cercano, respetuoso.
Recomendado Cuando agregues o actualices contenido de un proyecto existente, sigue estos pasos: revisa la guía de estilo, usa las listas de verificación, pide a otro redactor o a un editor que corrija el texto y solicita una edición de fondo si la crees necesaria.
No recomendado Cuando agregues o actualices contenido de un proyecto existente, sigue estos pasos: Revisa la guía de estilo, usa las listas de verificación, pide a otro redactor o a un editor que corrija el texto y solicita una edición de fondo si la crees necesaria.
Recomendado El manual lo dice sin vueltas: «Usar stop + start, no reload».
No recomendado El manual lo dice sin vueltas: «usar stop + start, no reload».

Un solo par de dos puntos por oración

Dos pares de dos puntos en la misma oración obligan al lector a decidir cuál manda. Parte la oración o usa paréntesis.

Recomendado El poller consulta dos servicios: cis-admin (puerto 8244) y el gateway (puerto 8270).
No recomendado El poller consulta dos servicios: cis-admin: puerto 8244, y el gateway: puerto 8270.

Ver también

Cómo puntuar el texto que introduce una lista o una muestra de código: Listas y Muestras de código. Cuándo conviene dos puntos en vez de una raya: Rayas y guiones.

Comas

La coma separa los elementos de una serie y ciertos tipos de cláusulas. En español la coma tiene dos prohibiciones firmes que el inglés no comparte: no va antes de la «y» o la «o» que cierra una serie simple y nunca separa el sujeto de su verbo.

Series

En una serie de tres o más elementos, no pongas coma antes de la conjunción final («y», «o», «ni»). La coma de Oxford que usa Google no existe en español.

Recomendado Las ubicaciones se dividen en zonas, regiones y multirregiones.
No recomendado Las ubicaciones se dividen en zonas, regiones, y multirregiones.

Sí va coma antes de la «y» cuando esa «y» no une el último elemento de la serie, sino que abre otra cosa: una oración nueva con sujeto propio o un elemento que ya contiene una «y».

Recomendado Revisó los asientos 602, 603 y 604, y aprobó el cierre del mes.
No recomendado Revisó los asientos 602, 603 y 604 y aprobó el cierre del mes.
Recomendado El respaldo cubre cis-admin, cochid-datos y cis-mailer, y el manual de operación.
No recomendado El respaldo cubre cis-admin, cochid-datos y cis-mailer y el manual de operación.

Coma tras palabras y frases introductorias

Pon coma después de una palabra o frase que abre la oración.

Recomendado Por último, en esta lista solo aparecen los grupos que contienen parámetros.
No recomendado Por último en esta lista solo aparecen los grupos que contienen parámetros.
Recomendado Según los requisitos de tu servicio, puedes implementar este método para actualizar la información del estado.
No recomendado Según los requisitos de tu servicio puedes implementar este método para actualizar la información del estado.

Coma entre dos oraciones independientes

Cuando una conjunción («y», «pero», «o», «ni», «así que», «sino») une dos oraciones independientes, pon coma antes de la conjunción si las oraciones tienen sujetos distintos o son largas. Si las dos son cortas y comparten sujeto, no pongas coma. Antes de «pero», «aunque» y «sino» la coma va siempre.

Recomendado Las bibliotecas simplifican la creación del feed, y el validador garantiza que solo se produzcan feeds válidos.
No recomendado Las bibliotecas simplifican la creación del feed y el validador garantiza que solo se produzcan feeds válidos.
Recomendado Escribe tu ID y haz clic en Aceptar.
No recomendado Escribe tu ID, y haz clic en Aceptar.
Recomendado El script exporta el asiento, pero no lo aprueba.
No recomendado El script exporta el asiento pero no lo aprueba.

Coma entre oración independiente y dependiente

Cuando una conjunción separa una oración independiente de una dependiente, pon coma solo si sin ella la oración se puede malentender.

Recomendado Las banderas de acceso directo son variables simples y se pueden leer directamente.
No recomendado Las banderas de acceso directo son variables simples, y se pueden leer directamente.
Recomendado El coordinador saludó al último integrante que entró en la sala, y abrió la reunión.
No recomendado El coordinador saludó al último integrante que entró en la sala y abrió la reunión.

En el segundo par, sin la coma no se sabe quién abrió la reunión: el coordinador o el integrante que entró.

Nunca entre sujeto y verbo

Una coma sola entre el sujeto y el verbo es un error, por largo que sea el sujeto.

Recomendado El servicio que emite los DTE y recibe los acuses corre en palena.
No recomendado El servicio que emite los DTE y recibe los acuses, corre en palena.

Cláusulas explicativas y especificativas

El inglés distingue «which» de «that»; el español usa «que» para ambas y la coma decide el sentido. Con coma, la cláusula explica algo del conjunto entero (explicativa). Sin coma, la cláusula restringe de qué elemento se habla (especificativa). Detalle en Pronombres.

Recomendado Nombre del grupo, que tiene un largo máximo de 200 caracteres.
No recomendado Nombre del grupo que tiene un largo máximo de 200 caracteres.

El ejemplo «No recomendado» no es agramatical: dice otra cosa. Afirma que hay varios grupos y que se habla del que mide 200 caracteres.

Conectores

Antes de un conector como «de lo contrario», «sin embargo», «por lo tanto» o «es decir», pon punto (preferido) o punto y coma; después del conector, coma. Sobre el punto y coma, ver Punto y coma.

Recomendado La variable debe tener un valor. De lo contrario, el servidor devuelve un error.
No recomendado La variable debe tener un valor de lo contrario el servidor devuelve un error.
Recomendado El drop-in apunta al release nuevo; sin embargo, el proceso viejo sigue vivo.
No recomendado El drop-in apunta al release nuevo, sin embargo el proceso viejo sigue vivo.

Coma antes de «porque»

No pongas coma antes de «porque» cuando la causa restringe el verbo. Ponla cuando la causa explica la afirmación completa y se podría quitar sin cambiar el sentido principal.

Recomendado Puedes usar el mismo nombre de clave en varios servicios y buckets, porque cada conjunto de claves es independiente de los demás.
No recomendado Puedes usar el mismo nombre de clave en varios servicios y buckets porque cada conjunto de claves es independiente de los demás.
Recomendado El respaldo falla porque pg_hba rechaza 127.0.0.1.
No recomendado El respaldo falla, porque pg_hba rechaza 127.0.0.1.

Vocativos e incisos

El nombre de la persona a la que hablas y los incisos van entre comas.

Recomendado Martín, el asiento 135 quedó anulado.
No recomendado Martín el asiento 135 quedó anulado.
Recomendado El pooler, medido el 14-08-2026, usa entre 69 y 87 de 100 conexiones.
No recomendado El pooler medido el 14-08-2026, usa entre 69 y 87 de 100 conexiones.

Comas en números

En español la coma es el separador decimal y el punto el de miles: «0,75», «1.215.716». Detalle en Números y en Punto final.

Comas en ejemplos

Cómo puntuar la palabra «ejemplo» y lo que la sigue: Ejemplos.

Rayas y guiones

La casa no usa la raya. La guía de Google la admite para marcar una interrupción en la oración; la norma de prosa la prohíbe sin excepciones (P05): es la marca más visible del texto generado y el linter la bloquea. Esta sección explica qué usar en su lugar. Para el guion corto, que sí se usa, ver Guion.

Qué usar en vez de la raya

Una interrupción o aclaración dentro de la oración va entre paréntesis. Una idea que merece su propio espacio va en oración nueva, después de un punto. El punto medio «·» sirve para separar datos cortos en una línea (títulos, pies, líneas de referencia, metadatos), no para reemplazar una coma dentro de la prosa.

Recomendado Ingresa un nombre para el release (por ejemplo, 2026-08-20-a1b2c3d) y luego ejecuta el despliegue.
No recomendado Ingresa un nombre para el release—por ejemplo, 2026-08-20-a1b2c3d—y luego ejecuta el despliegue.
Recomendado El respaldo escribe 13 bytes desde el 17-08-2026. La última copia buena se borra sola el 31-08-2026.
No recomendado El respaldo escribe 13 bytes desde el 17-08-2026—la última copia buena se borra sola el 31-08-2026.
Recomendado CIS · RUT 78.384.591-1 · Documento N.º 12
No recomendado CIS — RUT 78.384.591-1 — Documento N.º 12

Tampoco uses un guion con espacios (« - ») ni un guion doble («--») como raya improvisada. Si sientes que necesitas una raya, la oración pide paréntesis o un punto.

Recomendado El timer decía 30 minutos (en realidad corría cada 24 horas).
No recomendado El timer decía 30 minutos - en realidad corría cada 24 horas.

Semirraya

No uses la semirraya (el guion medio, –). Para rangos usa un guion o las palabras «de ... a» y «entre ... y». Detalle en Guion, Números y Unidades de medida.

Recomendado 8-20 archivos
No recomendado 8–20 archivos

Dos puntos en vez de rayas en listas de descripción

Una construcción común pero incorrecta usa una raya, una semirraya o un guion con espacios para separar un elemento de su descripción. Usa dos puntos o un punto. Para una serie de elementos, usa una lista de descripción en HTML (<dl>).

Recomendado Ejemplo: esto es un ejemplo.
No recomendado Ejemplo - esto es un ejemplo.
Recomendado Anexo A: mi primer anexo
No recomendado Anexo A—Mi primer anexo
Recomendado
<dl>
  <dt>cis-admin</dt>
  <dd>Contabilidad, CRM y emisión de DTE.</dd>
  <dt>cochid-datos</dt>
  <dd>Lago de datos públicos y sus ETL.</dd>
</dl>
No recomendado
cis-admin - Contabilidad, CRM y emisión de DTE.
cochid-datos - Lago de datos públicos y sus ETL.

Raya de diálogo

La raya de diálogo del español literario no aparece en la documentación del grupo. Una conversación de ejemplo (por ejemplo, en un chat de soporte) se presenta como lista o tabla con el nombre del interlocutor seguido de dos puntos.

Puntos suspensivos

En general, no uses puntos suspensivos. Son tres puntos seguidos e indican que se omitió parte de una oración, de un párrafo o de un bloque mayor, cuando esa omisión no afecta la comprensión del tema.

Puntos suspensivos como suspenso

Cuando los puntos suspensivos marcan vacilación o suspenso, se llaman puntos de suspensión. No los uses así en la documentación.

Recomendado La respuesta es que no debes hacer esto.
No recomendado La respuesta es... espera... que no debes hacer esto.

Puntos suspensivos en una interfaz

Cuando aparecen en una interfaz, déjalos fuera de la documentación que la describe, salvo que su ausencia confunda. Si el botón dice Guardar..., documenta «haz clic en Guardar». Detalle en Elementos de UI e interacción.

Recomendado Haz clic en Exportar y elige la carpeta.
No recomendado Haz clic en Exportar... y elige la carpeta.

Puntos suspensivos en el texto

No uses puntos suspensivos en tu propia prosa: omite lo innecesario e incluye todo lo necesario. Tampoco los uses para cerrar una enumeración abierta; si la enumeración no es completa, dilo («entre otros») o complétala. Nunca combines «etc.» con puntos suspensivos.

Recomendado El kit cubre cis-admin, cochid-datos y cis-mailer, entre otros.
No recomendado El kit cubre cis-admin, cochid-datos, cis-mailer...
Recomendado Dominios: cochid.cl, illanes00.cl, comentario.cl, etc.
No recomendado Dominios: cochid.cl, illanes00.cl, comentario.cl, etc...

Sí puedes usarlos dentro de una cita textual para reemplazar un fragmento omitido. En español la omisión dentro de una cita va entre corchetes, «[...]», para distinguirla de unos puntos suspensivos que estuvieran en el original. No se ponen al inicio ni al final de la cita: una cita puede empezar y terminar donde quieras sin avisar que había texto antes o después.

Recomendado La norma de prosa lo resume así: «El slop no se cura baneando palabras sueltas [...]. Se cura dándole al escritor un sistema verificable».
No recomendado La norma de prosa lo resume así: «[...] el modelo siempre rodea la lista negra. Se cura dándole al escritor un sistema verificable [...]».

Nunca escribas cuatro puntos. Si la omisión abarca el final de una oración, el punto del original queda antes o después del corchete, según corresponda, y sigue siendo un solo punto.

Recomendado «El slop no se cura baneando palabras sueltas [...]. Se cura dándole al escritor un sistema verificable».
No recomendado «El slop no se cura baneando palabras sueltas.... Se cura dándole al escritor un sistema verificable».

Puntuación y espaciado

Los tres puntos van juntos, escritos como tres puntos seguidos y no como el carácter «…»: tres puntos se buscan, se copian y se comparan en código sin sorpresas. Van pegados a la palabra anterior y separados por un espacio de la siguiente. Si los sigue otro signo (coma, punto y coma, cierre de interrogación), ese signo va pegado y sin espacio.

Recomendado No necesitas entender el resto del código Python que hay ahí... lo explicamos en clase.
No recomendado No necesitas entender el resto del código Python que hay ahí ... lo explicamos en clase.
Recomendado No necesitas entender el resto del código Python que hay ahí...; lo explicamos en clase.
No recomendado No necesitas entender el resto del código Python que hay ahí...lo explicamos en clase.

Después de puntos suspensivos la oración puede seguir en minúscula (si continúa la misma oración) o en mayúscula (si empieza otra).

Guion

Usa el guion (-) cuando hace falta para la claridad. El guion separa partes de una palabra para evitar una lectura equivocada y une términos que deben leerse como una unidad. El español usa muchos menos guiones que el inglés: los prefijos van soldados y los modificadores compuestos del inglés («well-designed») se traducen sin guion («bien diseñada»).

Orientación general

La regla de guion no siempre es directa, porque depende de tres cosas:

Hay muchas excepciones. Si dudas sobre un término, revisa estas fuentes en este orden:

  1. La documentación en la que trabajas. Si ya hay una convención para ese término, síguela.
  2. La lista de palabras de esta guía.
  3. El Diccionario panhispánico de dudas y la Ortografía de la RAE (2010).

Como siempre, desvíate de la regla cuando sirva al lector. Ver Documentación prescriptiva.

Nota: no uses un guion (-) ni un guion doble (--) como raya. La raya es otro signo y en la casa no se usa; ver Rayas y guiones.

Prefijos

En español el prefijo se escribe unido a la palabra, sin guion ni espacio.

Recomendado infraestructura, megabyte, metadatos, preprocesamiento, pseudocódigo, semiconductor, subdominio, multirregión, antivirus
No recomendado infra-estructura, mega-byte, meta-datos, pre-procesamiento, pseudo-código, semi-conductor, sub-dominio, multi-región, anti-virus

Excepciones

Pon guion después del prefijo en estos casos:

Si la base es una expresión de varias palabras, el prefijo va separado y sin guion.

Recomendado ex primer ministro, anti pena de muerte, pre Segunda Guerra Mundial, vice primer ministro
No recomendado ex-primer ministro, anti-pena de muerte, pre-Segunda Guerra Mundial, viceprimer ministro

El adverbio «no»

El inglés escribe «non-» como prefijo y duda entre «nonempty» y «non-empty». En español «no» es un adverbio: va separado y sin guion, delante de adjetivos y de sustantivos.

Recomendado valor no nulo, lista no vacía, usuario no interactivo, campo no clave, entero no negativo, la no intervención
No recomendado valor no-nulo, lista novacía, usuario no-interactivo, campo no-clave, entero no-negativo, la no-intervención

Compuestos

Un compuesto es un término que combina más de una palabra. Puede ser cerrado (una sola palabra), abierto (con espacios) o con guion.

Sustantivos compuestos

Antes de decidir el guion de un compuesto inglés, busca su equivalente en español en Anglicismos y su forma en español: casi siempre es una expresión abierta y el problema desaparece.

Recomendado página web, nombre de host, solución alternativa, compromiso, hoja de estilo
No recomendado web-page, host-name, work-around, trade-off, style-sheet

Cuando dos sustantivos forman un concepto y cada uno conserva su forma, llevan guion. Si el compuesto ya está soldado en el uso, va en una palabra.

Recomendado relación calidad-precio, pacto cliente-proveedor, coche cama, ciberseguridad, telediagnóstico
No recomendado relación calidad precio, pacto clienteproveedor, coche-cama, ciber-seguridad, tele-diagnóstico

Excepciones

La lista de palabras registra los términos asentados que llevan guion o espacio contra la regla. En algunos casos la versión sustantivo, verbo y adjetivo de una misma palabra se trata distinto.

Cuando los componentes de una unidad de medida se multiplican entre sí, van con guion.

Recomendado 5 vCPU-hora
No recomendado 5 vCPU hora
Recomendado 40 horas-persona
No recomendado 40 horas persona

Modificadores compuestos delante de un sustantivo

El inglés une con guion los modificadores que van delante del sustantivo («a well-designed app»). En español el adjetivo va detrás y no lleva guion. No calques el guion inglés.

Recomendado una app bien diseñada
No recomendado una bien-diseñada app
Recomendado técnicas específicas de Android
No recomendado técnicas Android-específicas

Dos adjetivos sí se unen con guion cuando cada uno conserva su sentido y su acento («teórico-práctico»); se sueldan en una palabra cuando forman un solo concepto («socioeconómico»).

Recomendado acuerdo chileno-argentino, curso teórico-práctico, revisión técnico-administrativa, análisis socioeconómico, cooperación hispanoamericana
No recomendado acuerdo chilenoargentino, curso teórico práctico, revisión técnico administrativa, análisis socio-económico, cooperación hispano-americana

Evita los modificadores de más de dos palabras. Mueve parte de las palabras detrás del sustantivo.

Recomendado casos de prueba específicos de la edición 2023
No recomendado casos de prueba edición-2023-específicos
Recomendado replicación entre centros de datos
No recomendado replicación cross-data-center

Números y unidades de medida

El inglés une con guion un número y su unidad cuando modifican a un sustantivo («a 64-bit system»). En español la construcción va con «de» y sin guion.

Recomendado un sistema de 64 bits
No recomendado un sistema 64-bits
Recomendado archivos de 100.000 bytes
No recomendado archivos de 100,000-bytes
Recomendado una espera de cinco minutos
No recomendado una espera de cinco-minutos

Entre el número y el símbolo de la unidad va un espacio duro (&nbsp;), nunca un guion, para que no se separen al final de una línea.

Recomendado disco de 200&nbsp;GB (disco de 200 GB)
No recomendado disco de 200-GB
Recomendado conexión de 50&nbsp;Mbps (conexión de 50 Mbps)
No recomendado conexión de 50Mbps

Detalle en Unidades de medida.

Adverbios en «-mente»

Un adverbio en «-mente» nunca se une con guion al adjetivo que modifica.

Recomendado implementaciones públicamente disponibles
No recomendado implementaciones públicamente-disponibles

No pongas guion en compuestos que por convención no lo llevan. Sigue la lista de palabras o la convención de la documentación en la que trabajas.

Recomendado un grupo de instancias administrado
No recomendado un grupo-de-instancias administrado
Recomendado un modelo de aprendizaje automático
No recomendado un modelo de aprendizaje-automático

Términos con guion fijo

Algunos términos llevan guion siempre, vayan donde vayan en la oración. Los nombres de los servicios y repos del grupo son identificadores: se escriben en código, con su guion, y no se traducen ni se parten al final de una línea.

Recomendado El poller entrega los acuses a cis-admin y el lago vive en cochid-datos.
No recomendado El poller entrega los acuses a cis admin y el lago vive en cochid datos.
Recomendado Los builds pasan por cis-build, que los serializa.
No recomendado Los builds pasan por cis-
build, que los serializa.

Rangos de números

Usa un guion, no una semirraya (&ndash;), para indicar un rango de números. Si el guion introduce ambigüedad, usa las palabras «de ... a», «entre ... y» o «hasta». No mezcles guion con palabras.

Recomendado 8-20 archivos
No recomendado 8 – 20 archivos
Recomendado 5-10 minutos
No recomendado 5 - 10 minutos
Recomendado de 8 a 20 archivos
No recomendado de 8-20 archivos
Recomendado entre 69 y 87 conexiones de 100
No recomendado entre 69-87 conexiones de 100

Para rangos con unidades y con números negativos, ver Números y Unidades de medida.

Espacios alrededor del guion

Nunca pongas espacio a ningún lado de un guion, salvo en el guion suspendido, donde puede ir un espacio después (pero no antes).

Guion suspendido

Cuando dos o más prefijos comparten una misma base, puedes conservar el guion y omitir la base en todos salvo el último. En estos ejemplos, la base es «procesamiento» y «conjuntos».

Recomendado El ETL separa el pre- y el posprocesamiento.
No recomendado El ETL separa el pre y el posprocesamiento.
Recomendado La consulta devuelve sub- y superconjuntos del catálogo.
No recomendado La consulta devuelve sub -y superconjuntos del catálogo.

Cuando la base no es un prefijo sino una palabra completa, el español repite la base o usa «o»: «intervalos de una o dos horas», no «intervalos de una- o dos-horas».

Paréntesis

A muchos nos gusta usar paréntesis. Una parte de los lectores se salta todo lo que va entre paréntesis, así que no pongas ahí información importante si puedes evitarlo.

Incluso para información menor, cada vez que quieras abrir un paréntesis pregúntate si hace falta. A veces sí; otras veces la oración o el párrafo funcionan igual de bien si quitas los paréntesis y separas la frase con comas o con un punto y una oración nueva. La casa no ofrece la raya como alternativa (P05).

Si necesitas paréntesis en medio de una oración, mantén corto lo que va dentro. Si no, usa dos oraciones.

Nota: si dentro de los paréntesis va una oración completa e independiente, el punto va dentro del paréntesis, no fuera. Detalle en Punto final.

Recomendado Ingresa un nombre para el release, por ejemplo 2026-08-20-a1b2c3d.
No recomendado Ingresa un nombre para el release (por ejemplo, 2026-08-20-a1b2c3d).
Recomendado Ingresa un número hexadecimal de seis dígitos (por ejemplo, 228B22) y luego haz clic en Aceptar.
No recomendado Ingresa un número hexadecimal de seis dígitos (por ejemplo, si quieres el color verde bosque, ingresa 228B22) y luego haz clic en Aceptar.
Recomendado Ingresa un número hexadecimal de seis dígitos y luego haz clic en Aceptar. Por ejemplo, si quieres el color verde bosque, ingresa 228B22.
No recomendado Ingresa un número hexadecimal de seis dígitos (que corresponde al color que quieres; por ejemplo, el verde bosque es 228B22 y el granate CDS es 7A1F2B) y luego haz clic en Aceptar.

En el primer par, el nombre de ejemplo es la información que el lector vino a buscar: no la escondas entre paréntesis.

Siglas, RUT y aclaraciones de identidad

La primera vez que aparece una sigla, la forma completa va primero y la sigla entre paréntesis. Lo mismo con un RUT o un dato de identificación que acompaña a un nombre.

Recomendado Compañía de Innovación de Santiago SpA (CIS) opera vps-cis.
No recomendado CIS (Compañía de Innovación de Santiago SpA) opera vps-cis.
Recomendado COCHID SpA (RUT 78.374.391-4) terminó su giro ante el SII.
No recomendado COCHID SpA, RUT 78.374.391-4, (terminó su giro ante el SII).

Paréntesis dentro de paréntesis

Si necesitas un inciso dentro de otro, usa corchetes para el interior. Mejor aún: reescribe para no necesitarlo.

Recomendado El informe (versión 12, publicada el 06-08-2026 [la última]) fija el núcleo en 1.215.716 recetas.
No recomendado El informe (versión 12, publicada el 06-08-2026 (la última)) fija el núcleo en 1.215.716 recetas.

Plurales opcionales

No uses paréntesis para indicar un plural opcional ni una doble forma de género. Detalle en Plurales y Lenguaje inclusivo.

Recomendado Selecciona los archivos que quieras respaldar.
No recomendado Selecciona el (los) archivo(s) que quieras respaldar.

Punto final

Toda oración completa termina con punto, salvo que sea una pregunta. Las listas y los títulos tienen sus propias reglas.

Punto en listas

Si un elemento de lista termina con punto depende de varios factores, entre ellos el tipo de lista. Detalle en la sección de mayúsculas y puntuación final de Listas.

Punto con URL

Cuando un punto sigue de inmediato a una URL o a una ruta de archivo, cuesta saber si el punto es parte de la URL. Para dejarlo claro, prueba una de estas técnicas:

Si la URL es un enlace, se ve distinta del texto que la rodea (en casi todos los navegadores el enlace cambia de color) y eso ayuda a separarla del punto.

Recomendado Usamos tus comentarios para mejorar el servicio, según la política de privacidad del grupo:
https://www.innovacionsantiago.cl/legal/privacidad/
No recomendado Usamos tus comentarios para mejorar el servicio, según la política de privacidad del grupo en https://www.innovacionsantiago.cl/legal/privacidad/.

Cuando sí pongas un punto después de una URL, no dejes espacio entre el último carácter de la URL y el punto.

Punto con comillas

En español el punto va fuera de la comilla de cierre, aunque el inglés lo ponga dentro. La regla vale también para la coma y el punto y coma, y vale tanto para las comillas angulares como para las rectas.

Recomendado ... y en el mensaje de commit puedes escribir «Corrige error tipográfico».
No recomendado ... y en el mensaje de commit puedes escribir «Corrige error tipográfico.»

Si lo que va entre comillas termina en signo de interrogación o exclamación, el punto de la oración principal va igual después de la comilla de cierre. El inglés lo suprime; el español no.

Recomendado Los niños siempre preguntan «¿por qué?».
No recomendado Los niños siempre preguntan «¿por qué?»

Detalle en Comillas.

Punto con paréntesis

Si la última parte de una oración va entre paréntesis, el punto va después del paréntesis de cierre. Si los paréntesis encierran una oración completa e independiente, el punto va dentro.

Recomendado La aplicación puede mostrar una notificación cuando cambia un archivo o una carpeta relevante (incluso si el cambio ocurre mientras la aplicación no está corriendo).
No recomendado La aplicación puede mostrar una notificación cuando cambia un archivo o una carpeta relevante (incluso si el cambio ocurre mientras la aplicación no está corriendo.)
Recomendado Las aplicaciones detrás de cis-auth son fáciles de crear, mantener y proteger. (Con cis-auth no tienes que mantener un servidor de identidad propio.)
No recomendado Las aplicaciones detrás de cis-auth son fáciles de crear, mantener y proteger. (Con cis-auth no tienes que mantener un servidor de identidad propio).

Detalle en Paréntesis.

Punto en títulos

Los títulos y encabezados no terminan con punto. Detalle en Títulos y encabezados.

Recomendado Gotcha Caddy: reload no relee EnvironmentFile
No recomendado Gotcha Caddy: reload no relee EnvironmentFile.

Punto en números

En español el punto separa los miles y la coma marca el decimal. Es lo contrario de la costumbre de Estados Unidos que sigue Google. Los años no llevan punto de miles.

Recomendado 1.215.716 recetas · 0,46 % del PIB · $6.232 · año 2026
No recomendado 1,215,716 recetas · 0.46% del PIB · $6,232 · año 2.026

La excepción es el código y los datos de máquina: JSON, CSV, SQL y las salidas de un comando usan punto decimal y no llevan separador de miles. No «traduzcas» los números dentro de un bloque de código.

Recomendado El endpoint devuelve {"ratio": 0.75, "filas": 149000}; es decir, un 75 % sobre 149.000 filas.
No recomendado El endpoint devuelve {"ratio": 0,75, "filas": 149.000}.

Detalle en Números.

Punto en leyendas de figuras

Ver Figuras e imágenes.

Punto en texto alternativo

Ver Accesibilidad.

Punto en abreviaturas

Una palabra abreviada lleva punto: «pág.», «núm.», «N.º», «etc.», «Sr.». Las siglas no llevan punto entre sus letras ni al final: CIS, RUT, SII, API, DTE. Los símbolos de unidades tampoco: km, GB, h. Detalle en Abreviaturas.

Recomendado Documento N.º 12, pág. 4, emitido por CIS ante el SII.
No recomendado Documento Nº 12, pag 4, emitido por C.I.S. ante el S.I.I.

Espacios entre oraciones

Deja un solo espacio entre oraciones.

Signos de interrogación

En español la pregunta abre con «¿» y cierra con «?». Después del signo de cierre no va punto; sí puede ir coma u otro signo si la oración continúa.

Recomendado ¿El servicio responde en el puerto 8244? Si no, revisa el drop-in.
No recomendado El servicio responde en el puerto 8244?. Si no, revisa el drop-in.

Signos de exclamación

En general, evita los signos de exclamación. Suenan poco profesionales o alarmantes y se traducen mal. Si los usas, van en pareja: «¡» al abrir y «!» al cerrar. Por tipo de contenido:

Cuándo son aceptables:

Recomendado El certificado quedó emitido.
No recomendado ¡El certificado quedó emitido!
Recomendado ¡Listo! Completaste la configuración.
No recomendado Listo! Completaste la configuración!

Nota: por el impacto en la traducción, sé conservador con las exclamaciones en documentación para audiencia global. En idiomas como el japonés o el coreano una exclamación puede leerse como un grito. Ver Audiencia global.

Comillas

En prosa usa comillas angulares («»). Dentro de un texto ya entrecomillado, comillas rectas dobles (""). Las comillas simples ('') solo aparecen en código y en un tercer nivel de anidamiento. Las comillas tipográficas inglesas (“ ” y ‘ ’) no se usan.

Cuándo usar comillas

En la escritura técnica las comillas se usan poco, fuera de los casos de código. Sirven para títulos de obras cortas, como artículos o episodios de una serie web, salvo que el título sea parte de un enlace. Detalle en Referencias cruzadas y enlaces. Los títulos de obras completas van en cursiva.

Ejemplos de cuándo usar comillas en texto corriente:

CasoEjemplo
Referir una sección de un documento mayor, si no puedes enlazar la sección directamente.El procedimiento está en la sección «Gotcha Caddy» del manual de operación de vps-cis.
Referir el título del documento padre cuando ya enlazas una sección.La sección Guion de «Guía de escritura» explica cuándo se sueldan los prefijos.
Citar textualmente a una persona o reproducir un lema.Orwell lo dijo en 1946: «Nunca uses una palabra larga donde sirve una corta».
Usar un término en sentido metafórico, solo si no es un uso asentado en el dominio.Esta configuración forma una «isla» dentro de la red que no se conecta con el exterior.

Detalle en Resumen de formato de texto.

Comas y puntos con comillas

La coma y el punto van fuera de la comilla de cierre. La regla inglesa que sigue Google los pone dentro; en español no.

Recomendado Ver la sección titulada «Cuidado y alimentación del emú».
No recomendado Ver la sección titulada «Cuidado y alimentación del emú.»

Lo mismo vale para una palabra clave u otra cadena literal entre comillas: las comillas marcan una cadena exacta, así que no metas nada ajeno dentro. Con todo, una cadena literal va mejor en fuente de código y sin comillas, salvo que las comillas sean parte de la cadena. Detalle en Código en el texto.

Recomendado Si escribes escape, el programa se cae.
No recomendado Si escribes "escape," el programa se cae.
Aceptable Si escribes "escape", el programa se cae.
No recomendado Si escribes "escape", el programa se cae.

Comillas angulares, rectas y tipográficas

Casi todas las fuentes traen tres juegos de comillas: angulares («»), rectas ("") y tipográficas inglesas (“”). Algunas herramientas, como Google Docs, convertirán las rectas en tipográficas mientras escribes. La regla de la casa es angulares en prosa y rectas en código y en literales, por estas razones:

Cómo escribir las angulares: en HTML, &laquo; y &raquo;. En Linux, con la tecla Compose seguida de << o >> (en la distribución española, AltGr+Z y AltGr+X). En macOS con distribución de EE. UU., Opción+\ y Opción+Mayús+\. En Windows, Alt+174 y Alt+175 en el teclado numérico.

Recomendado El título de la sección es «Cuidado y alimentación del emú».
No recomendado El título de la sección es “Cuidado y alimentación del emú”.
Recomendado Ejecuta vault get cis-mailer RESEND_API_KEY.
No recomendado Ejecuta vault get “cis-mailer” RESEND_API_KEY.

Comillas simples

Las comillas simples solo se usan en estos casos:

Para anidar una cita dentro de otra, la cita principal va entre comillas angulares y la cita interior entre comillas rectas dobles. Solo si hay un tercer nivel aparecen las simples.

Recomendado Ella dijo: «Lo escuché gritar "¡Ayuda!" y lo vi debatirse en el agua».
No recomendado Ella dijo: 'Lo escuché gritar "Ayuda", y lo vi debatirse en el agua'.
Recomendado SELECT * FROM asientos WHERE estado = 'aprobado';
No recomendado SELECT * FROM asientos WHERE estado = «aprobado»;

Nota: para el uso de comillas con enlaces, ver Referencias cruzadas y enlaces.

Punto y coma

Si puedes, evita el punto y coma. El punto y una oración nueva casi siempre dicen lo mismo con menos esfuerzo para el lector. En modo estricto (procedimientos, runbooks, mensajes de error, UI) la norma de prosa lo prohíbe sin excepciones (P31).

En prosa normal hay tres casos en que el punto y coma es la mejor opción:

Unir dos oraciones independientes muy ligadas

Cuando un punto las separaría demasiado y una coma sola es un error (dos oraciones independientes no se unen con coma).

Recomendado Puedes probar la compatibilidad calculando el centroide; si queda al otro lado del planeta, invierte el orden de los vértices.
No recomendado Puedes probar la compatibilidad calculando el centroide, si queda al otro lado del planeta, invierte el orden de los vértices.

Antes de un conector

Antes de un conector como «por lo tanto» o de una frase como «es decir» que une dos oraciones independientes. Después del conector va coma.

Recomendado El pooler mantiene cinco conexiones mínimas por base; por lo tanto, catorce bases ocupan setenta conexiones aunque nadie consulte.
No recomendado El pooler mantiene cinco conexiones mínimas por base, por lo tanto catorce bases ocupan setenta conexiones aunque nadie consulte.
Recomendado El release activo; es decir, el directorio al que apunta el drop-in de systemd.
No recomendado El release activo, es decir el directorio al que apunta el drop-in de systemd.

Separar una serie de elementos largos o con puntuación propia

Recomendado Si no tienes tiempo, concéntrate en las mejoras de mayor beneficio: lo que más importa a tus usuarios; lo más urgente de corregir; y lo que es fácil o viable de corregir en el tiempo disponible.
No recomendado Si no tienes tiempo, concéntrate en las mejoras de mayor beneficio: lo que más importa a tus usuarios, lo más urgente de corregir, y lo que es fácil o viable de corregir en el tiempo disponible.
Recomendado Revisa el documento una vez más y verifica lo siguiente: presente y voz activa; errores tipográficos, puntuación y gramática; y si puedes acortar algo.
No recomendado Revisa el documento una vez más y verifica lo siguiente: presente y voz activa, errores tipográficos, puntuación y gramática, y si puedes acortar algo.

En el último ejemplo el segundo elemento es a su vez una lista; sin el punto y coma el lector no sabe dónde termina. Si la serie se vuelve así de compleja, considera una lista con viñetas (Listas).

Modo estricto: cero punto y coma

En procedimientos, runbooks, mensajes de error y textos de interfaz el punto y coma no se usa. Ninguna de las tres excepciones anteriores aplica: punto y oración nueva, o una lista. Es la regla P31 de la norma de prosa, tomada del Español Técnico Simplificado (ETS 8.10).

Recomendado La variable debe tener un valor. Si no, el servidor devuelve un error.
No recomendado La variable debe tener un valor; de lo contrario, el servidor devuelve un error.
Recomendado Detener Caddy. Iniciar Caddy. Verificar que el sitio responde.
No recomendado Detener Caddy; iniciar Caddy; verificar que el sitio responde.

Barras

Evita las barras, salvo en código, en rutas y en URL.

Barras en fechas

No uses formatos de fecha con barras. La casa escribe 20-08-2026 en datos y tablas, y «20 de agosto de 2026» en prosa. Detalle en Fechas y horas.

Recomendado Publicada el 06-08-2026. · Publicada el 6 de agosto de 2026.
No recomendado Publicada el 06/08/2026. · Publicada el 8/6/26.

Barras para alternativas

No uses barras para separar alternativas. Di «y» o «o», según lo que quieras decir.

Recomendado Por ejemplo, un mapa de ayuda en desastres no queda sujeto a los límites de uso aunque lo haya desarrollado y lo aloje una entidad comercial.
No recomendado Por ejemplo, un mapa de ayuda en desastres no queda sujeto a los límites de uso aunque lo haya desarrollado/alojado una entidad comercial.
Recomendado Por ejemplo, un mapa de ayuda en desastres no queda sujeto a los límites de uso aunque lo haya desarrollado o lo aloje una entidad comercial.
No recomendado Por ejemplo, un mapa de ayuda en desastres no queda sujeto a los límites de uso aunque lo haya desarrollado/alojado una entidad comercial.
Recomendado Llama a este método cinco o seis veces.
No recomendado Llama a este método 5/6 veces.

Tampoco uses la barra para dobles terminaciones de género. Reformula con un plural genérico o con un sustantivo colectivo. Detalle en Lenguaje inclusivo.

Recomendado Bienvenida al equipo. · Las personas usuarias pueden exportar sus datos.
No recomendado Bienvenido/a al equipo. · Los/as usuarios/as pueden exportar sus datos.

«y/o»

En español la «o» ya admite que se cumplan las dos opciones, así que «y/o» sobra casi siempre. Si necesitas dejar explícito que valen ambas, escribe «o ambos». Evita «y/o» salvo cuando el espacio es muy limitado, como en una tabla.

Recomendado Puedes ver y editar tus propios datos.
No recomendado Puedes ver y/o editar tus propios datos.
Recomendado Puedes exportar eventos crudos, eventos procesados o ambos.
No recomendado Puedes exportar eventos crudos y/o procesados.

Barras en rutas de archivo y URL

Usa la barra normal (/) en rutas de archivo y en URL, como corresponde a cada sistema.

Nota: si documentas una ruta de Windows, usa la barra invertida (\).

Recomendado https://datos.cochid.cl/mirror/dipres/ · /srv/projects/cis/cis-admin/
No recomendado https:\\datos.cochid.cl\mirror\dipres\ · \srv\projects\cis\cis-admin\

Cuando una URL muy larga no cabe en una línea, corta la línea justo después de una barra. Nunca agregues un guion a una URL para partirla en dos líneas: el lector no sabrá si el guion es parte de la dirección.

Recomendado https://developers.google.com/
style/slashes
No recomendado https://developers.google.com/sty-
le/slashes

Barras en fracciones

No uses barras en fracciones, porque quedan ambiguas. En el ejemplo, «3/4» se puede leer como tres cuartos o como «4 es una alternativa a 3». Recuerda que el decimal va con coma.

Recomendado ¾ · 0,75 · 75 %
No recomendado 3/4 · 0.75

Barras en abreviaturas

No uses abreviaturas que dependen de una barra. Escribe las palabras completas. En un campo de dirección postal, «s/n» (sin número) es aceptable porque es la forma oficial.

Recomendado a cargo de, con, cada uno, con copia, sin número
No recomendado a/c, c/, c/u, c/c, s/n

Barras en unidades y en código

La barra sí es correcta en unidades compuestas por división y en cualquier contexto de código: expresiones regulares, operadores, rutas, flags.

Recomendado 128 ms de latencia · 50 MB/s · 120 km/h · grep -E "a/b"
No recomendado 50 MB por cada s · 120 km por cada h

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).