twltr/ux-copy

UX Copy

Skill folha em Design; acessada pelo seu domínio ou por nome.

O texto de interface é lido de passagem, no meio da tarefa e muitas vezes sob estresse. Ele funciona quando a pessoa sabe o que vai acontecer e o que fazer em seguida; palavras genéricas como "Enviar", "OK" ou "Algo deu errado" a fazem adivinhar. Escreva a partir da situação do usuário e do resultado real da ação, no idioma da própria interface.

Um exemplo prático

Solicitação (produto fictício): "As pessoas estão apagando projetos sem querer. Revise este diálogo: Tem certeza? [OK] [Cancelar]"

Excluir "Lançamento Q3"?
Suas 14 tarefas e todos os arquivos são removidos para todos da equipe.
Isso não pode ser desfeito.
                                      [Cancelar]  [Excluir projeto]

O título nomeia a ação e o objeto, o corpo declara a consequência que o torna grave, e o botão destrutivo repete o verbo para que seja lido por si só. "Cancelar" permanece: é a saída familiar, e renomeá-lo não acrescenta nada.

Trabalhe a partir da situação

Estabeleça a tela ou fluxo, o que a pessoa está tentando fazer e como ela provavelmente se sente, a voz do produto e os termos existentes, e restrições como limites de caracteres, convenções da plataforma e idiomas-alvo. Cópias passadas como argumentos são o texto a ser revisado. Quando detalhes estiverem faltando, escreva com premissas declaradas em vez de enviar um questionário; pergunte apenas onde a resposta altera a cópia, como tratamento formal ou informal.

Seções marcadas com ~~ nomeiam uma categoria de ferramenta, não um produto: ~~design tool (por exemplo Figma) ou ~~knowledge base (por exemplo Notion). Use qualquer ferramenta conectada dessa categoria que o host forneça; pule a etapa quando não houver nenhuma.

Com uma ~~knowledge base, leia primeiro a voz da marca, o guia de estilo de conteúdo e a terminologia. Com uma ~~design tool, observe a tela em seu fluxo e extraia os limites de caracteres do layout.

Cópia em outros idiomas

Escreva nativamente no idioma da interface; cópia redigida em inglês e traduzida mantém a estrutura do inglês e soa estrangeira. Responda no idioma da solicitação, mas escreva as strings no idioma da interface — os dois podem diferir, como em uma pergunta em inglês sobre um aplicativo em alemão. Os padrões abaixo valem para todos os idiomas; essas convenções mudam como eles são expressos:

• Forma de tratamento. Muitos idiomas escolhem entre um "você" formal e informal (alemão, francês, espanhol, holandês). Siga a escolha existente do produto; sem uma, proponha uma e aplique-a em todos os lugares, incluindo erros.
• Forma verbal em controles. Interfaces em alemão, francês e espanhol convencionalmente rotulam botões e itens de menu com o infinitivo, não o imperativo. Siga a convenção da plataforma e do produto.
• Capitalização. Minúscula inicial para frases é uma regra do inglês. O alemão capitaliza substantivos em qualquer lugar da frase; nunca aplique título em inglês a outro idioma.
• Tipografia e formatos. Use as aspas do idioma, espaçamento (o francês coloca um espaço antes de ! ? : ;), e formatos de número, data e moeda.
• Comprimento. Alemão e francês geralmente são um terço mais longos que o inglês, e strings curtas muito mais; compostos longos não quebram. Verifique a largura real e ative a hifenização com o atributo lang correto.

Em uma revisão, verifique isso quanto à consistência em todas as strings, não apenas dentro de uma.

Padrões

Elemento	O que deve fazer	Exemplo
Botão, CTA	Verbo mais objeto; nomeie o resultado; mantenha o nome ao longo do fluxo	"Publicar" → toast "Publicado"
Erro	O que aconteceu e como corrigir; a causa apenas onde ajuda a correção; nunca culpe, nunca um código simples	"Seu banco recusou este cartão. Tente outro cartão ou entre em contato com seu banco."
Erro de campo	Diga o que é necessário, não o que está errado	"Insira uma data posterior a hoje"
Estado vazio	O que aparecerá aqui e como começar; sem resultados sugere alterar a pesquisa	"Nenhuma fatura ainda. Crie uma ou importe de um arquivo CSV."
Confirmação	Nomeie a ação e o objeto, declare a consequência, rotule o botão com o verbo	Veja o exemplo prático
Dica de ferramenta	Adicione o que o rótulo não pode dizer; nunca repita o rótulo	—
Carregamento	Diga o que está acontecendo; defina expectativas para longas esperas	"Importando 2.400 contatos. Isso pode levar um minuto."
Sucesso	Confirme o resultado específico	"Fatura enviada para Dana" em vez de "Sucesso!"
Integração	Um conceito por passo, ligado a algo que a pessoa faz	—

A voz permanece a do produto; o tom se move com o momento. Erros são calmos e específicos: empatia significa reconhecer o impacto e ajudar a corrigi-lo, não pedir desculpas por reflexo ou brincar. Sucesso é breve, avisos são diretos.

Saída

Para um elemento, dê a recomendação e uma frase sobre por que ela se adequa à situação da pessoa. Ofereça alternativas apenas onde a escolha é genuinamente aberta, como uma compensação de tom ou comprimento:

## UX copy: [contexto]

**[Elemento]:** [cópia]
[Por que isso funciona para a pessoa neste momento]

| Opção | Cópia | Melhor para |
|---|---|---|
| A | [cópia] | [quando usar] |

**Notas de localização:** [apenas quando a cópia é traduzida ou enviada em vários idiomas: expressões a evitar, expansão, forma de tratamento, contexto cultural]

Para uma revisão de várias strings, use uma tabela para que cada alteração seja rastreável:

| Localização | Atual | Proposto | Por quê |
|---|---|---|---|
| Checkout, erro de cartão | "Erro 402" | "Seu banco recusou este cartão. Tente outro cartão." | Diz o que aconteceu e o próximo passo |

Layout, tipografia e hierarquia visual estão fora deste método; também estão textos de marketing longos, artigos e e-mails, que precisam de um método de redação em vez de padrões de microcópia.