twltr/ux-copy

UX Copy

Habilidad hoja en Diseño; se accede a través de su dominio o por nombre.

El texto de la interfaz se lee de paso, en medio de una tarea y a menudo bajo estrés. Funciona cuando la persona sabe qué va a pasar y qué hacer a continuación; palabras genéricas como "Enviar", "Aceptar" o "Algo salió mal" la obligan a adivinar. Escribe desde la situación del usuario y el resultado real de la acción, en el propio idioma de la interfaz.

Un ejemplo práctico

Solicitud (producto ficticio): "La gente está eliminando proyectos por accidente. Revisa este diálogo: ¿Estás seguro? [Aceptar] [Cancelar]"

¿Eliminar "Lanzamiento Q3"?
Sus 14 tareas y todos los archivos se eliminan para todos los miembros del equipo.
Esto no se puede deshacer.
                                   [Cancelar]  [Eliminar proyecto]

El título nombra la acción y el objeto, el cuerpo indica la consecuencia que lo hace grave, y el botón destructivo repite el verbo para que se lea por sí solo. "Cancelar" se mantiene: es la salida familiar, y renombrarlo no aporta nada.

Trabajar desde la situación

Establece la pantalla o flujo, qué está intentando hacer la persona y cómo se siente probablemente, la voz del producto y los términos existentes, y las restricciones como límites de caracteres, convenciones de la plataforma e idiomas de destino. El texto pasado como argumentos es el texto a revisar. Cuando falten detalles, escribe con suposiciones declaradas en lugar de enviar un cuestionario; pregunta solo donde la respuesta cambie el texto, como el tratamiento formal o informal.

Las secciones marcadas con ~~ nombran una categoría de herramienta, no un producto: ~~herramienta de diseño (por ejemplo Figma) o ~~base de conocimiento (por ejemplo Notion). Usa la herramienta conectada de esa categoría que proporcione el anfitrión; omite el paso cuando no haya ninguna.

Con una ~~base de conocimiento, lee primero la voz de la marca, la guía de estilo de contenido y la terminología. Con una ~~herramienta de diseño, observa la pantalla en su flujo y toma los límites de caracteres del diseño.

Texto en otros idiomas

Escribe de forma nativa en el idioma de la interfaz; el texto redactado en inglés y traducido conserva la estructura inglesa y suena foráneo. Responde en el idioma de la solicitud, pero escribe las cadenas en el idioma de la interfaz — ambos pueden diferir, como en una pregunta en inglés sobre una app alemana. Los patrones siguientes se aplican en todos los idiomas; estas convenciones cambian la forma de expresarlos:

• Forma de tratamiento. Muchos idiomas eligen entre un "tú" formal y uno informal (alemán, francés, español, neerlandés). Sigue la elección existente del producto; si no hay una, propón una y aplícala en todas partes, incluidos los errores.
• Forma verbal en controles. Las interfaces en alemán, francés y español suelen etiquetar botones y elementos de menú con el infinitivo, no el imperativo. Sigue la convención de la plataforma y del producto.
• Capitalización. El uso de mayúscula inicial solo en la primera palabra es una regla del inglés. El alemán escribe los sustantivos con mayúscula en cualquier parte de la oración; nunca apliques el título en inglés a otro idioma.
• Tipografía y formatos. Usa las comillas del idioma, los espacios (el francés pone un espacio antes de ! ? : ;) y los formatos de número, fecha y moneda.
• Longitud. El alemán y el francés suelen ser un tercio más largos que el inglés, y las cadenas cortas mucho más; los compuestos largos no se dividen. Verifica el ancho real y habilita la separación silábica con el atributo lang correcto.

En una revisión, verifica la consistencia de estos aspectos en todas las cadenas, no solo dentro de una.

Patrones

Elemento	Qué debe hacer	Ejemplo
Botón, CTA	Verbo más objeto; nombra el resultado; mantén el nombre a lo largo del flujo	"Publicar" → toast "Publicado"
Error	Qué pasó y cómo solucionarlo; la causa solo si ayuda a la solución; nunca culpes, nunca un código solo	"Tu banco rechazó esta tarjeta. Prueba con otra tarjeta o contacta con tu banco."
Error de campo	Di qué se necesita, no qué está mal	"Introduce una fecha posterior a hoy"
Estado vacío	Qué aparecerá aquí y cómo empezar; sin resultados sugiere cambiar la búsqueda	"Aún no hay facturas. Crea una o importa desde un archivo CSV."
Confirmación	Nombra la acción y el objeto, indica la consecuencia, etiqueta el botón con el verbo	Ver el ejemplo práctico
Tooltip	Añade lo que la etiqueta no puede decir; nunca repitas la etiqueta	—
Carga	Di qué está pasando; establece expectativas para esperas largas	"Importando 2400 contactos. Esto puede llevar un minuto."
Éxito	Confirma el resultado específico	"Factura enviada a Dana" en lugar de "¡Éxito!"
Incorporación	Un concepto por paso, vinculado a algo que la persona hace	—

La voz sigue siendo la del producto; el tono se adapta al momento. Los errores son tranquilos y específicos: la empatía significa reconocer el impacto y ayudar a solucionarlo, no disculparse por reflejo ni bromear. El éxito es breve, las advertencias son directas.

Resultado

Para un elemento, da la recomendación y una frase sobre por qué se adapta a la situación de la persona. Ofrece alternativas solo cuando la elección sea realmente abierta, como un compromiso de tono o longitud:

## UX copy: [contexto]

**[Elemento]:** [texto]
[Por qué funciona para la persona en este momento]

| Opción | Texto | Mejor para |
|---|---|---|
| A | [texto] | [cuándo usarlo] |

**Notas de localización:** [solo cuando el texto se traduzca o se envíe en varios idiomas: modismos que evitar, expansión, forma de tratamiento, contexto cultural]

Para una revisión de varias cadenas, usa una tabla para que cada cambio sea trazable:

| Ubicación | Actual | Propuesto | Por qué |
|---|---|---|---|
| Checkout, error de tarjeta | "Error 402" | "Tu banco rechazó esta tarjeta. Prueba con otra tarjeta." | Dice qué pasó y el siguiente paso |

El diseño, la tipografía y la jerarquía visual quedan fuera de este método; también los textos extensos de marketing, artículos y correos electrónicos, que necesitan un método de redacción en lugar de patrones de microcopia.