Lenguaje y gramática

Catorce temas sobre cómo se arma una oración en la documentación del grupo: siglas y abreviaturas, voz, persona, tiempo verbal, artículos, mayúsculas, concordancia, pronombres y el orden de las partes. Cada tema traduce la sección correspondiente de la guía de Google y la adapta al español: donde el inglés tiene una regla propia (artículos a/an, contracciones, Title Case, preposición al final), la reemplaza la regla equivalente del español. Donde la norma de prosa de la casa va más lejos que Google, la norma gana y se cita por su id (P01 a P37, en core/prosa/NORMA.md).

Tres reglas de la casa atraviesan toda la sección y se repiten donde corresponde. Cero raya (P05: se usa «·», «y», «hasta», paréntesis o punto y oración nueva). Nunca voseo (P06: español neutro con tú). Tildes siempre, también en mayúsculas y en siglas desarrolladas.

Abreviaturas

Las abreviaturas agrupan cuatro cosas distintas: siglas, acrónimos, abreviaturas propiamente tales (palabras cortadas con punto) y símbolos. Las contracciones y apócopes tienen su propio tema.

En la mayoría de los contextos la diferencia técnica entre sigla y acrónimo no importa: puedes decir «sigla» para las dos.

• Una sigla se forma con las iniciales de una frase y se deletrea: SII por Servicio de Impuestos Internos, RUT por rol único tributario, API por interfaz de programación de aplicaciones, DTE por documento tributario electrónico.
• Un acrónimo también se forma con iniciales o con sílabas, pero se pronuncia como una palabra: OTAN, pyme, ovni, láser. Cuando el acrónimo ya entró al diccionario se escribe en minúscula (pyme, ovni) y toma plural normal (pymes).
• Una abreviatura es una parte de la palabra, con punto al final: Dr. por doctor, pág. por página, art. por artículo, etc. por etcétera, n.º por número.
• Un símbolo es una forma normalizada internacional, sin punto y sin plural: min por minutos, km por kilómetros, GB por gigabytes, h por horas, CL por Chile.

Formas largas y cortas de una palabra

Algunas palabras tienen una versión larga y una corta. Por ejemplo:

• aplicación y app
• demostración y demo
• fotografía y foto
• bicicleta y bici

Las versiones cortas (acortamientos) no son abreviaturas; si las usas, no llevan punto.

Si no sabes si una forma es abreviatura o acortamiento, busca en la lista de palabras. Si eso no lo resuelve, aplica la prueba del habla: si dices la forma corta como una palabra («esta es la versión demo del producto»), normalmente puedes tratarla como palabra y no como abreviatura.

Cuándo usar abreviaturas

Las abreviaturas existen para ahorrarle tiempo a quien escribe y a quien lee. Si la lectora tiene que detenerse a pensar qué significa una sigla, la abreviatura la frena en vez de ayudarla.

Lo que sí y lo que no

• Usa las siglas estándar que le ahorran tiempo a quien lee.
• Desarrolla la abreviatura en la primera mención. Más detalle en Cuándo desarrollar un término.
• Evita las abreviaturas de términos que no son el tema central del documento.

  En el ejemplo siguiente el tema del documento es la facturación electrónica, así que «certificado digital» y «prestador de servicios de certificación» no se abrevian.

  Recomendado Los documentos tributarios electrónicos (DTE) se firman con el certificado digital que emite un prestador de servicios de certificación acreditado.

  No recomendado Los DTE (documentos tributarios electrónicos) se firman con el CD (certificado digital) que emite un PSC (prestador de servicios de certificación) acreditado.
• Desconfía de las abreviaturas especializadas que tu audiencia puede no conocer. Sobre cuándo usar ese lenguaje, consulta Jerga.

Cuándo desarrollar un término

En general, cuando la audiencia puede no conocer una abreviatura, desarróllala en la primera mención y pon la abreviatura entre paréntesis justo después.

En todas las menciones siguientes usa la abreviatura sola. Si el término aparece una sola vez, incluye la abreviatura solo si crees que es tan común como la forma desarrollada; si no, omítela.

Si la primera mención ocurre en un título o encabezado, puedes usar la abreviatura ahí y desarrollarla en el primer párrafo que sigue.

Para decidir si desarrollas un término, piensa en la audiencia. Si el documento se va a traducir, la forma desarrollada da contexto a la traducción humana y a la automática. También ayuda a quien lee en español como segunda lengua. Si la mayoría de la audiencia reconoce el término, no hace falta desarrollarlo: en documentación para desarrolladores que menciona una API no necesitas escribir «interfaz de programación de aplicaciones». Si explicas qué es una API a alguien sin experiencia en programación, desarrollarla sí ayuda.

En algunos casos desarrollar el término no ayuda a entenderlo. Escribir «formato de documento portátil» no le aclara a nadie qué es un PDF. En esos casos, no lo desarrolles.

Estas abreviaturas rara vez necesitan desarrollarse:

• IA
• API
• DVD
• Formatos de archivo como PDF o XML
• HTML
• PC
• RAM
• REST
• RUT (ante audiencia chilena)
• Unidades como MB, MiB, GB o GiB
• URL
• USB

Formato de la primera mención

Cuando desarrollas un término y pones la abreviatura entre paréntesis:

• Escribe las dos formas en redonda. Google pone la forma desarrollada y la sigla en cursiva; en español la cursiva no se usa para esto y la casa sigue al español. Reserva la cursiva para los usos de Cursivas en términos.
  Recomendado Establece sesiones del protocolo de puerta de enlace de frontera (BGP) con un router de la red vecina.

  No recomendado Establece sesiones del protocolo de puerta de enlace de frontera (BGP) con un router de la red vecina.
• Escribe la forma desarrollada en minúscula, salvo que sea un nombre propio o se escriba con mayúscula por convención. No la pongas en mayúsculas solo porque la sigla las lleva.
  Recomendado lenguaje de manipulación de datos (DML) · rol único tributario (RUT) · Servicio de Impuestos Internos (SII)

  No recomendado Lenguaje de Manipulación de Datos (DML) · Rol Único Tributario (RUT)
• Conserva las tildes de la forma desarrollada (rol único tributario), aunque la sigla no las lleve.
• Incluye la abreviatura dentro del texto del enlace cuando la primera mención es un enlace.

Género y artículo de la sigla

La sigla toma el género y el número del sustantivo núcleo de la forma desarrollada. Así: la API (la interfaz), el SII (el servicio), el RUT (el rol), el DTE (el documento), la ONG (la organización). Las siglas extranjeras toman el género de la traducción: la URL (la dirección), el PDF (el formato). Cuando hay duda, usa la forma que la audiencia ya dice. Más en Artículos.

Abreviaturas que no se usan

No uses i.e. ni e.g.; escribe «es decir» y «por ejemplo». Tampoco «p. ej.» en prosa corrida: solo dentro de paréntesis y tablas donde el espacio manda.

Puedes usar «etc.» en algunos casos, pero en la mayoría de las listas conviene otra redacción. Consulta Comas.

No uses abreviaturas de jerga de internet ni de chat: tl;dr, ymmv, RTFM, xq, tb, q, dsp. Escribe lo que quieres decir, sin figuras.

Usa la forma más común de la palabra. Si la palabra completa es común y se entiende, úsala en vez de abreviarla: escribe «aproximadamente», no «aprox.»; «número», no «n.º», salvo en tablas; «usted» nunca abreviado.

Desarrolla los acortamientos y los símbolos que reemplazan palabras.

Puntos en las abreviaturas

• Sin puntos en siglas y acrónimos: SII, no S.I.I.; RUT, no R.U.T. La excepción son las abreviaturas por duplicación (EE. UU., RR. HH.), que llevan punto y espacio; si puedes, evítalas y escribe la forma completa.
• Con punto al final de las abreviaturas de palabra cortada: pág., art., etc., Dr.
• Sin punto en símbolos de unidades, de fecha y de hora: 64 GB, 15 min, 3 h, 20-08-2026.
• Sin punto en acortamientos que se dicen como palabra: app, demo.
• Sin punto en códigos de país y de región: CL, US, RM.

Plural de abreviaturas

Las siglas no cambian en plural: el artículo marca el número (las API, los PC). Las abreviaturas sí pluralizan (págs.). Los símbolos nunca (64 GB). Detalle y ejemplos en Plurales.

Abreviaturas como verbos

No uses siglas, acrónimos ni abreviaturas como verbos.

Artículo antes de una abreviatura

En inglés la elección entre a y an depende de la pronunciación de la sigla. En español el artículo depende del género y el número del núcleo (ver arriba) y el único ajuste fonético es el de «el/un» ante /a/ tónica: el ARN, un AVE. Más en Artículos.

Voz activa

En general usa la voz activa (el sujeto gramatical es quien hace la acción) en vez de la pasiva (el sujeto recibe la acción), con algunas excepciones. Deja claro quién hace qué. Esta es la regla P23 de la norma de la casa, que en modo estricto (procedimientos, runbooks, mensajes de error) se vuelve P30: ahí la activa es la única forma admitida.

En la pasiva es fácil olvidar quién o qué hace la acción, y entonces quien lee no sabe si le toca hacer algo a ella, al computador, al servidor, a la usuaria final o a quien visita la página.

En la pasiva se puede indicar quién actúa (con «por»), pero la prosa resultante casi siempre es peor que la misma oración en activa. Siempre que puedas, haz sujeto a quien actúa.

La pasiva refleja

El español tiene una tercera forma que el inglés no tiene: la pasiva refleja con «se» («el archivo se guarda», «se encontraron 50 conflictos»). Es más natural que la pasiva con «ser» y es la forma correcta cuando el agente no importa. Prefiérela siempre sobre «es guardado», «fueron encontrados». En modo estricto también cuenta como pasiva (P30): ahí reescribe en activa («cis-admin guarda el archivo») o en infinitivo-imperativo.

Excepciones

En ciertos casos la pasiva es aceptable. Por ejemplo:

• Para destacar el objeto por sobre la acción.
  Recomendado El archivo queda guardado.
• Para quitarle peso al sujeto o al agente.
  Recomendado Se encontraron más de 50 conflictos en el archivo.

  No recomendado Creaste más de 50 conflictos en el archivo.
• Cuando quien lee no necesita saber quién es responsable de la acción.
  Recomendado La base de datos se depuró en enero.

Antropomorfismo

No atribuyas cualidades humanas al software ni al hardware.

El antropomorfismo es una forma de lenguaje figurado: es menos preciso y suele ser más difícil de entender y de traducir que el lenguaje directo. La norma de la casa lo trata como metáfora (P22). Más en Audiencia global.

Verbos que delatan antropomorfismo: ver, saber, querer, pensar, creer, acordarse, quejarse, entender, decidir. Reemplázalos por lo que el sistema hace en realidad: detectar, leer, registrar, devolver, comparar, seleccionar, responder con error.

Artículos

Para que el texto se entienda y se traduzca bien, escribe los artículos determinados e indeterminados (el, la, los, las, un, una, unos, unas). No los omitas por brevedad, tampoco en títulos ni en encabezados. El estilo telegráfico de los títulos en inglés («Create VM instance») no se traslada al español.

Reglas propias del español

• «El» y «un» ante /a/ tónica. Los sustantivos femeninos que empiezan con a o ha tónica llevan «el» y «un» en singular: el área, el agua, un hacha, el alza. El adjetivo sigue en femenino (el área completa) y el plural vuelve a «las» (las áreas). No aplica con adjetivos (la alta disponibilidad) ni con letras (la a).
• Género de las siglas y de los préstamos. La sigla toma el género del núcleo (la API, el SII, el RUT); el préstamo toma el del equivalente en español o el del uso establecido: el backend, el token, el hash, la caché, el commit, la build. Cuando existe la palabra en español, prefiérela (el respaldo, la compilación) y consulta Anglicismos y su forma en español.
• Contracciones obligatorias. «a + el» siempre es «al» y «de + el» siempre es «del», salvo ante nombres propios que llevan el artículo dentro (de El Mercurio). Detalle en Contracciones y apócopes.
• Nombres de producto del grupo. Van sin artículo cuando son el nombre del servicio (cis-admin registra el asiento; cochid-datos expone la tabla) y con artículo cuando son descripciones (el manual de operación, el archivo societario, el data lake). Más en Nombres de producto del grupo.

Sobre el orden normal de las palabras y sobre escribir para una audiencia global, consulta Audiencia global. Sobre títulos, Títulos y encabezados.

Mayúsculas

Sigue las reglas de mayúsculas del español (Ortografía de la RAE, 2010). Además:

• No pongas mayúsculas innecesarias. Antes de escribir una palabra con mayúscula, piensa por qué (y si) la lleva.
• No dependas de una diferencia de mayúscula para transmitir un significado. Quien conoce cis-admin tal vez entienda que «Asiento» con mayúscula es la entidad del modelo y «asiento» es cualquier asiento contable, pero esa distinción se pierde para quien lee de pasada o llega nuevo al tema. Si es código, escríbelo como código (Asiento).
• No escribas en mayúsculas sostenidas, salvo en nombres oficiales, en siglas que siempre se escriben así o al citar código que las usa.
• No uses mayúsculas internas (camelCase), salvo en nombres oficiales o al citar código que las usa.
• Las mayúsculas llevan tilde: ÁREA, Ítem, ÚNICO. Quitarla es una falta de ortografía, no una opción tipográfica.
• Sobre cómo escribir palabras específicas, consulta la lista de palabras.

Lo que en español va en minúscula

Varias categorías que el inglés escribe con mayúscula van en minúscula en español. Entre ellas: los días (lunes), los meses (agosto), las estaciones, los idiomas (español, inglés), los gentilicios (chileno, santiaguino), los cargos (el gerente general, la presidenta, el contador) y las disciplinas (contabilidad, derecho). Los nombres de instituciones sí van con mayúscula en cada palabra significativa (Servicio de Impuestos Internos, Compañía de Innovación de Santiago SpA), y las leyes y decretos llevan mayúscula solo en «Ley» o «Decreto» seguidos de número (Ley 19.628).

Mayúsculas en nombres de producto

Sobre cómo escribir los nombres de producto, consulta Nombres de producto del grupo. Los servicios del grupo se escriben en minúscula y con guion, también al inicio de oración: cis-admin, cochid-datos, cis-mailer.

Mayúsculas en títulos y encabezados

En títulos y encabezados usa minúscula de oración. Lleva mayúscula solo la primera palabra, la primera palabra después de dos puntos y los nombres propios u otros términos que siempre se escriben de una forma. El Title Case del inglés es una señal de texto traducido o generado y la norma lo marca (P37).

Aunque uses minúscula de oración, no pongas punto al final del título ni del encabezado.

Mayúsculas al citar títulos y encabezados

Al citar el título o el encabezado de un documento que sigue esta guía, usa minúscula de oración aunque el original use otra cosa. Así, cuando el original se corrija, la referencia ya coincide.

Al citar el título de una obra o fuente que no sigue esta guía, conserva la forma original.

Más sobre referencias internas y externas en Referencias cruzadas y enlaces; sobre el formato de fuentes de terceros, en HTML y etiquetado semántico.

Mayúsculas y dos puntos

Después de dos puntos, la primera palabra va en minúscula, salvo que el texto sea:

• un nombre propio (software de código abierto: Hadoop);
• un encabezado; ver Mayúsculas en títulos y encabezados;
• una cita textual (el manual lo dice: «Pre-crear los archivos de log con install»);
• el texto que sigue a una etiqueta como «Precaución» o «Nota»;
• el cuerpo de una carta o correo después del saludo (Estimado Jorge: Adjunto el acta).

Mayúsculas en figuras

Usa minúscula de oración en las leyendas y en las etiquetas, llamadas y cualquier otro texto dentro de imágenes y diagramas.

Mayúsculas en glosarios e índices

Escribe los términos de glosario e índice en minúscula, salvo que el término sea nombre propio o tenga otra razón para llevar mayúscula. Usa minúscula de oración en las definiciones.

Mayúsculas y palabras con guion

Cuando una palabra con guion abre una oración o un encabezado, pon mayúscula solo en el primer elemento, salvo que otro elemento sea nombre propio o adjetivo derivado de uno (Chileno-argentino).

Mayúsculas en listas

Usa minúscula de oración en los elementos de todo tipo de lista. Más en Listas.

Mayúsculas en tablas

Usa minúscula de oración en todos los elementos de una tabla: contenido, encabezados, etiquetas y leyendas.

Nombres de estilos de mayúsculas

No uses el nombre de un estilo (camel case, snake case) para describir cómo se escribe algo. Esos nombres no se traducen bien y no están normalizados. Explica el requisito y da un ejemplo.

Contracciones y apócopes

La guía de Google recomienda las contracciones del inglés (you're, don't) porque dan tono informal. El español no tiene ese recurso: sus contracciones son dos y obligatorias, y lo que sí tiene son los apócopes. Este tema cubre las dos cosas.

Contracciones obligatorias: al y del

«A + el» se escribe siempre «al» y «de + el» se escribe siempre «del». No es una opción de estilo.

La única excepción es el nombre propio que lleva el artículo como parte del nombre: «la portada de El Mercurio», «el sitio de El Mostrador». Con nombres de producto del grupo no hay artículo, así que no hay contracción: «el panel de cis-admin».

Apócopes obligatorios

Algunos adjetivos pierden la sílaba final ante un sustantivo. Usarlos completos en esa posición es un error:

• primer, tercer (el primer respaldo, el tercer intento), solo ante masculino singular: la primera copia;
• buen, mal, algún, ningún (un buen resultado, ningún error), solo ante masculino singular;
• gran (un gran volumen), ante cualquier sustantivo singular;
• cualquier (cualquier archivo), ante cualquier sustantivo singular;
• cien (cien registros), ante sustantivo o ante mil y millones;
• tan, muy, recién (tan lento, muy rápido, recién instalado), ante adjetivo, adverbio o participio.

Negaciones

En inglés, Google prefiere don't a do not porque al leer rápido es fácil saltarse el not suelto. En español «no» es siempre una palabra aparte, así que la precaución se traslada a otra cosa: pon el «no» junto al verbo y cerca del inicio de la oración, donde quien lee lo ve primero.

Si necesitas enfatizar la negación, puedes usar formato (<b>no</b>, que se ve como «no»). En la mayoría de los casos no hace falta.

Contracciones y apócopes que no se usan

• No escribas contracciones del habla: pa', na', p'al, ta', m'hijo. Van completas: para, nada, para el, está.
• No uses acortamientos coloquiales en documentación: profe, compu, depa, finde, porfa. Sí puedes usar los acortamientos asentados en el uso técnico (app, demo, foto); ver Abreviaturas.
• No inventes apócopes ni contracciones que el español no tiene («la 1ra. vez» se escribe «la primera vez»; «c/u» se escribe «cada uno»).
• No uses las contracciones del chat (q, xq, tb, dsp). Están en Abreviaturas que no se usan.

Plurales

Sigue las reglas de plural del español y usa la forma regular en la mayoría de los casos. No formes plurales con apóstrofo («API's»): el apóstrofo no existe en el plural español y confunde el plural con el posesivo inglés.

Más en Contracciones y apócopes y Posesivos.

Singular y plural: concordancia

En oraciones con sujeto largo o complejo, asegúrate de que el verbo concuerde con el núcleo del sujeto y no con el sustantivo más cercano.

En oraciones con más de un sujeto unidos por «y» o por «o», elige el número que corresponde: dos sujetos con «y» piden plural; con «o» el verbo puede ir en singular si la alternativa es excluyente.

Para mantener el estilo, después de «uno o más» usa plural, no singular. Como «uno o más» admite varias lecturas, a veces conviene reescribir.

Ver también Plurales entre paréntesis.

Después de «más de un» usa singular, no plural.

Plural de siglas y abreviaturas

Las siglas son invariables por escrito: el plural lo marca el artículo o el determinante. Esta es la regla de la RAE y la de la casa. No agregues «-s» ni «'s»: al hablar sí se pronuncia el plural (/las ápis/), pero no se escribe.

Los acrónimos que ya son palabras comunes sí pluralizan como palabras: pymes, ovnis, láseres.

Cuando desarrollas un término, la forma desarrollada y la sigla tienen que coincidir en número.

Con números y unidades de medida, si escribes la unidad con todas sus letras usa el singular cuando el número es uno y el plural para cualquier otro número, incluidos el cero, los decimales y los mayores que uno. Los decimales van con coma.

No pluralices el símbolo de una unidad cuando va con un número.

Nota: a veces ayuda escribir con letras los términos con «-bit» o «-byte». En general, no hace falta desarrollar la unidad cuando va con un número concreto.

Deja un espacio (de preferencia un espacio duro,  ) entre el número y el símbolo: 64 GB, no 64GB. Más en Unidades de medida.

Plural de nombres de producto y de clases

En general no formes plural ni posesivo de la marca registrada de un producto, de una función o de una empresa. Más en Marcas registradas y en Nombres de producto, función y empresa.

Usa los nombres de clase en singular. No pluralices a mano un nombre de clase; eso rompe la traducción y el código. Agrega un sustantivo en plural después del nombre.

Más en Comentarios en referencia de API.

Plurales entre paréntesis

No escribas plurales opcionales entre paréntesis. Elige singular o plural y mantén esa elección en todo el documento, según lo que más convenga a la audiencia. Si en un contexto concreto importa decir ambos, usa «uno o más».

La misma regla vale para los desdoblamientos de género con paréntesis, arroba, equis o «-e» (usuario(a), usuari@s, usuarixs, usuaries): no se usan. Las alternativas están en Lenguaje inclusivo.

Plural de préstamos

Cuando existe la palabra en español, úsala y pluralízala en español (respaldos, no backups; clics; currículums; másteres). Si el término técnico se queda en inglés porque así lo conoce la audiencia (commits, tokens, scripts), pluralízalo con «-s» y sin cursiva. Más en Anglicismos y su forma en español.

Pronombres en plural

Sobre los pronombres en plural (nosotros, ustedes, ellos), consulta Pronombres y Segunda persona.

Posesivos

El inglés forma el posesivo con 's; el español no tiene ese recurso y lo expresa con «de», con los posesivos (su, tu, nuestro) o con «cuyo». Las reglas de Google se traducen así:

• La posesión se marca con «de» + sustantivo.
  Recomendado Modifica el registro de cada vector.

  Recomendado Sube la cuota de la clase de almacenamiento.

  No recomendado Modifica cada vector's registro.
• No calques el apóstrofo: ni en plural ni en posesivo.
  Recomendado Amplía las capacidades de los modelos.

  No recomendado Amplía los modelos' capacidades.
• Si el posesivo queda forzado, reescribe la oración sin él.
  Recomendado Analiza los datos del negocio.

  No recomendado Analiza los datos pertenecientes a los negocios.
  Recomendado La resolución que emitió el Servicio de Impuestos Internos (SII).

  No recomendado La resolución del Servicio de Impuestos Internos (del SII).

«Su» ambiguo

El problema propio del español es «su»: vale para él, ella, ellos, ellas, usted y ustedes. Cuando hay más de un posible dueño, reemplázalo por «de + nombre» o reescribe.

Posesivos que sobran

El inglés repite your y its donde el español usa el artículo. Cuando la pertenencia es obvia, usa el artículo; el posesivo repetido es un calco.

Nombres de producto, función y empresa

Al describir una función o el rendimiento de algo, no conviertas en posesivo el nombre de una función, de un producto ni de una marca registrada, sea de quien sea. Usa «de» para indicar la relación y no uses el nombre como adjetivo pegado.

Para indicar que algo pertenece a una empresa, usa «de + nombre de la empresa». No lo hagas cuando el nombre se usa como marca registrada de un producto.

Sobre usar marcas como modificadores y no como sustantivos, consulta Marcas registradas.

Elementos de código

No formes el posesivo de un elemento de código ni le pegues artículos o sufijos. Acompaña el elemento con el sustantivo que lo describe (el método, la tabla, el campo) y forma la relación desde ese sustantivo, o reescribe.

«Cuyo» sigue siendo el posesivo relativo correcto y reemplaza al «que su» (quesuismo).

Más en Código en el texto.

Preposiciones

La guía de Google aclara que en inglés no hay nada malo en terminar una oración con preposición. En español la regla es la contraria: la preposición va siempre delante de su término y nunca queda suelta al final. Coloca la preposición donde la oración se lee más fácil, que en español es junto al relativo.

Incluye las preposiciones que aportan claridad, omite las innecesarias y no cargues la oración con demasiadas.

Dequeísmo y queísmo

Los dos errores de preposición más frecuentes en español son poner un «de» que no va (dequeísmo) y quitar un «de» que sí va (queísmo). La prueba: sustituye la subordinada por «eso». Si la oración pide «de eso», lleva «de que»; si pide «eso», lleva «que».

Régimen de algunas palabras

Estas locuciones se escriben con la preposición que el español exige y no con el calco del inglés:

• de acuerdo con (no «de acuerdo a»), en relación con (no «en relación a»);
• según, con base en (no «en base a»);
• consistir en, depender de, basarse en, constar de;
• desde mi punto de vista (no «bajo mi punto de vista»);
• «a nivel de» solo con niveles reales (a nivel del mar); para lo demás la norma lo marca como muletilla (P18): en vez de «a nivel de servicio», «en el servicio».

Sobre qué preposición usar al referirte a elementos de interfaz (en la página, en el menú, haz clic en), consulta Elementos de UI e interacción.

Presente

Usa el presente para las afirmaciones que describen un comportamiento general, sin relación con un momento concreto.

Sí puedes usar el futuro para distinguir una acción que de verdad ocurre más tarde.

En el ejemplo siguiente el futuro es apropiado porque cis-mailer entrega de forma asíncrona: el destinatario no recibe el correo en el instante en que se encola.

No uses el futuro para describir cómo va a funcionar un producto o una función después de la próxima versión. Más en Funciones futuras.

Evita también el condicional hipotético («el servidor te eliminaría»):

Lo que agrega la norma en modo estricto

En procedimientos, runbooks, mensajes de error y textos de interfaz, la norma de la casa reduce el repertorio verbal al del Español Técnico Simplificado:

• P27: sin tiempos compuestos. «Ha revisado» se vuelve «revisa», o dos oraciones.
• P28: solo tres perífrasis: está + participio, puede + infinitivo, debe + infinitivo. «Va a instalar», «tiene que verificar» y «podrá instalar» no se admiten.
• P32: sin condicional, salvo la lista cerrada.
• P26: sin subjuntivo: «según sea necesario» se vuelve «cuando es necesario».

Pronombres

Asegúrate de que cada pronombre remite con claridad a su antecedente (el sustantivo al que reemplaza). En español hay un riesgo extra: el sujeto tácito. Cuando el verbo va sin sujeto explícito, quien lee tiene que adivinar cuál de los sustantivos anteriores actúa.

Referencias ambiguas

Evita las referencias vagas o confusas entre el pronombre (o el sujeto tácito) y su antecedente.

En muchos casos lo mejor es poner un sustantivo después del demostrativo (este, esta, estos, estas).

No uses «el mismo» o «la misma» como pronombre: es un burocratismo (P13). Usa el pronombre átono o repite el sustantivo.

Género

No uses pronombres con género salvo que la persona a la que te refieres tenga ese género. En inglés Google resuelve el caso genérico con el they singular; el español no tiene un equivalente aceptado, así que la solución es otra: reescribe. Usa el plural («quienes operan el servicio»), un sustantivo colectivo o epiceno («la persona», «el equipo»), el tú directo, o quita el pronombre. No uses «él/ella», «(a)», «@», «x» ni «-e». Las técnicas están en Lenguaje inclusivo.

Relativos que no se omiten

En inglés se puede omitir that y Google pide no hacerlo. En español «que» nunca se omite, así que la regla se traslada al caso equivalente: no reemplaces la oración de relativo por un participio suelto ni por una construcción absoluta. El «que» explícito quita ambigüedad.

Más en Pronombres relativos.

Pronombres personales

Evita la primera persona (yo, nosotros, nos, nuestro) salvo en estos contextos:

• las preguntas de una sección de preguntas frecuentes;
• un documento cuyo autor comenta en primera persona, con firma;
• el «nosotros» que se refiere a la organización, después de nombrarla. Por ejemplo: «Compañía de Innovación de Santiago opera cis-admin. No garantizamos la disponibilidad fuera de la ventana de soporte».

Usa la segunda persona (tú) siempre que puedas. No escribas el pronombre «tú» explícito salvo para contrastar: la desinencia verbal ya lo dice y repetirlo es un calco del inglés. Más en Segunda persona.

Pronombres átonos: le, lo, la

El español neutro de la casa sigue el uso etimológico: «lo» y «la» para el complemento directo (el archivo: guárdalo; el acta: fírmala) y «le» para el indirecto (envíale el correo al contador). Evita el leísmo de persona («le vi») y el laísmo («la dije»). Con «usted» como objeto directo también va «lo» o «la».

Pronombres relativos

Hay varios relativos. Esta sección trata solo tres: que, el cual y quien.

La diferencia de that y which en inglés (restrictivo sin coma, no restrictivo con coma) existe igual en español, pero la marca la coma y no el pronombre:

• Una oración especificativa restringe al antecedente y va sin coma.
  Recomendado El servidor que tiene 64 GB de RAM es el de producción.

  Esta oración describe un servidor en particular: el que tiene 64 GB.

• Una oración explicativa agrega información de paso y va entre comas. Ahí puedes usar «que» o «el cual».
  Recomendado El servidor, que tiene 64 GB de RAM, es el de producción.

  Esta oración habla de un único servidor y menciona de pasada que tiene 64 GB.

Más sobre las dos clases de oración en Comas.

Cuando el antecedente es una persona puedes usar «quien» en vez de «que» («el contador, quien aprueba los asientos»). Si no estás seguro de cuál corresponde, «que» siempre sirve. «Quien» no va en especificativas con antecedente explícito: «el contador que aprueba», no «el contador quien aprueba».

«Cuyo» es el posesivo de «que» y de «quien» y vale para personas, animales y cosas.

Segunda persona

Dirígete a quien lee con tú

En general dirígete a quien lee en segunda persona y no en primera: tú y tu, no nosotros ni nuestro. La casa usa el tú del español neutro (P06): puedes, tienes, imprime. Nunca el voseo (podés, imprimí) y, en documentación, tampoco usted; usted queda para contratos, comunicaciones con organismos públicos y textos legales de formato obligatorio, donde se marca con prosa-ok.

Supón que quien lee es la persona que hace las tareas o toma las decisiones. Usa la palabra «usuario» solo para la persona que usa el software que tu lectora desarrolla.

Si le dices a quien lee que haga algo, usa el imperativo (el tú queda implícito). Por ejemplo:

Puedes usar el imperativo en el texto corrido una vez que está claro a quién le hablas. Pero piensa si ese texto no debería ir con formato de procedimiento.

En modo estricto (procedimientos, runbooks), la norma cambia la forma de la orden: va en infinitivo-imperativo («Examinar todo el sistema»), no en imperativo morfológico («Examina») (P29). La persona sigue siendo quien lee; solo cambia la forma verbal. Más en Procedimientos.

Hay situaciones donde el tú no es exacto ni apropiado. Usa la segunda persona para lo que hace quien lee y la tercera para lo que hace el software o una usuaria final. En la documentación de una API, por ejemplo, los hechos sobre los elementos de programación van en tercera persona, y las instrucciones sobre qué hacer con ellos, en tú.

Usa el plural de primera persona con cuidado

Puedes usar nosotros, nuestro y nos para referirte a la organización que figura como autora del documento, siempre que el antecedente quede claro.

Dirígete a la audiencia de forma consistente

Define quién es el «tú» al que le hablas (¿una desarrolladora? ¿un operador del servidor? ¿un cliente?) y mantén esa elección. Deja claro a quien lee quién esperas que sea, a veces con una oración de audiencia explícita al inicio del documento: «Este manual es para quien opera vps-cis con acceso sudo».

Estructura de la oración

Si vas a pedirle a quien lee que haga algo, menciona primero la circunstancia, la condición o el objetivo y después la instrucción. Poner la circunstancia primero le permite saltarse la instrucción si no le aplica. Sobre cómo aplicar esto en procedimientos, consulta Procedimientos.

Lo que agrega la norma

La norma de la casa fija límites medibles para la oración y el párrafo, y marca tres estructuras que delatan texto generado:

• P11: máximo 40 palabras por oración (25 en modo estricto). Si una oración pasa el límite, córtala con un punto, no con una coma ni con una raya.
• P12: máximo 8 oraciones por párrafo (6 en estricto), un tema por párrafo y la oración temática al inicio.
• P33: sin gerundio analítico colgante al final de la oración. La conclusión no cuelga de una coma.
  Recomendado El data lake llegó a doce regiones. Es la cobertura más amplia del ecosistema.

  No recomendado El data lake llegó a doce regiones, consolidando su posición como referente.
• P34: sin coletilla valorativa («, lo que demuestra», «, lo que refleja»). Corta en la coma; si no se pierde ningún hecho, era opinión.
  Recomendado El respaldo de cochid-datos escribe 13 bytes desde el 17-08-2026.

  No recomendado El respaldo de cochid-datos escribe 13 bytes desde el 17-08-2026, lo que refleja la fragilidad del proceso.
• P02: sin antítesis retórica («no es solo X, es Y»). Afirma directo.
  Recomendado cis-verify valida documentos por QR y por checksum.

  No recomendado cis-verify no es solo un validador de QR, es una garantía de confianza.
• P05: la raya no sirve para unir dos ideas en una oración. Usa punto y oración nueva, paréntesis o el punto medio.
  Recomendado El poller corre cada 10 minutos (el timer de systemd lo dispara) y entrega al gateway.

  No recomendado El poller corre cada 10 minutos — el timer de systemd lo dispara — y entrega al gateway.

Regla de juicio: el dato primero y la interpretación después (data-forward). En una oración con cifra, la cifra no espera al final.

Verbos en documentos de referencia

Cuando escribes la referencia de un método, redacta la descripción principal en términos de lo que el método hace (obtiene, lista, crea, busca). No la redactes en términos de lo que la desarrolladora haría con él (obtener, listar, crear, buscar).

En inglés la diferencia es una «-s» al final del verbo. En español la diferencia está entre la tercera persona del presente («crea») y el infinitivo («crear»), y hay una trampa extra: «crea» también es el imperativo de tú. El contexto de una referencia (sujeto = el método) deshace la ambigüedad; el infinitivo no se usa ahí.

No confundas esta regla con la de los procedimientos: en modo estricto la orden a quien lee va en infinitivo-imperativo («Reiniciar el servicio», P29). Son dos textos distintos: la referencia describe qué hace el código; el procedimiento le dice a una persona qué hacer.

Para parámetros y valores de retorno sirven los fragmentos nominales sin verbo («Nombre del libro.», «Lista de asientos aprobados.»), siempre con punto final y en minúscula de oración. Más ejemplos en Comentarios en referencia de API.

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