Marcus Andrey Estudo
Read in English Biblioteca

Design systems · Passo 4 · 8 min de leitura

Conteúdo e voz no sistema

As palavras de um componente fazem parte do componente. Como um design system mantém uma voz que não muda e um tom que muda, regras de conteúdo para botões, erros e rótulos, textos guardados com chaves, traduções e limites de tamanho, e quem cuida deles.

As pessoas leem a sua interface antes de olhar para ela. A cor de um botão vem de um token, o espaçamento de outro, e o rótulo vem de quem estava com pressa naquele dia. É assim que um produto acaba com "Enviar", "Mandar", "OK", "Confirmar" e "Pronto" para a mesma ação. Um design system que cuida das cores e não das palavras cuida da parte que as pessoas menos percebem.

O que você vai conseguir fazer depois de ler:

  • Explicar voz e tom, e escrever a voz de um sistema em poucas linhas
  • Escrever regras de conteúdo para os componentes mais usados
  • Guardar textos como tokens: com chaves, traduções e limites de tamanho
  • Decidir quem cuida das palavras, e como elas mudam

1. A voz fica, o tom muda

O guia de estilo de conteúdo do Mailchimp tem a versão mais clara: "você tem a mesma voz o tempo todo, mas o seu tom muda" (Mailchimp, Voice and tone). O design system da Atlassian diz o mesmo para as suas interfaces: a voz é "ousada, otimista, prática, com uma piscadela", e o tom "deve mudar conforme a situação em que a pessoa está (por exemplo, recebendo um erro ou concluindo um projeto com sucesso)" (Atlassian, Voice and tone).

O NN/g dá um jeito de descrever o tom com precisão, em quatro dimensões: formal ou casual, sério ou engraçado, respeitoso ou irreverente, entusiasmado ou objetivo (Moran, The Four Dimensions of Tone of Voice, NN/g, 2016).

App de reservas · travessia cancelada

Sua travessia das 09:40 foi cancelada

Ventos fortes na Ilha de Mara. Sua reserva está garantida: escolha outra travessia ou peça o reembolso total.

Tom: sério, calmo, sem piada

Console da equipe · o mesmo evento

09:40 Kestrel Bay → Ilha de Mara cancelada, clima

142 passageiros para remarcar. Avisos enviados às 08:52.

Tom: curto e factual; a equipe está ocupada

App de reservas · reservado

Reserva feita

Até logo em Kestrel Bay. O embarque fecha 15 minutos antes da partida.

Tom: caloroso, um pouco mais leve

Fora da voz: não faça

Ops! A Mãe Natureza tinha outros planos

Erro WX-409: travessia indisponível.

Uma piada sobre uma viagem estragada, e um código que ninguém consegue usar

Uma voz, três tons, e uma mensagem fora da voz. A voz do Harbour é a mesma em todo lugar (simples, calma, útil); o tom muda com a situação da pessoa. O console da equipe é mais seco porque a equipe lê entre uma tarefa e outra, não porque tem outra voz.

A voz do Harbour cabe em três palavras: simples, calma, útil. O tom, nas dimensões do NN/g: sempre respeitoso; casual no app de reservas, mais objetivo no console; nunca engraçado quando algo deu errado. A quarta mensagem da figura não está errada por ser casual. Está errada porque faz piada com uma viagem estragada e entrega às pessoas um código que elas não conseguem usar.


2. Regras de conteúdo dentro dos componentes

Uma voz é geral demais para escrever um botão. Os componentes precisam de regras, escritas na documentação ao lado das props. As do Harbour, para os componentes deste passo:

  • Button. Um verbo para a ação, só a primeira letra maiúscula, duas ou três palavras: "Reservar travessia", "Ver bilhete". O GOV.UK Design System pede o mesmo: escrever o texto do botão com só a primeira letra maiúscula, descrevendo a ação que ele faz (GOV.UK, Button). Uma confirmação repete a ação ("Cancelar reserva"), nunca "Sim" ou "OK".
  • Text field. Um rótulo que dá nome à coisa ("Sobrenome"), uma dica para o formato, e nenhum placeholder no lugar de nenhum dos dois (veja Componentes acessíveis).
  • Mensagem de erro. O que aconteceu e como resolver. O GOV.UK: descreva o que aconteceu e diga como corrigir, em linguagem simples e positiva, e nunca com palavras como "proibido", "ilegal" ou "você esqueceu" (GOV.UK, Error message). Os pares de rótulo e erro deles são um bom modelo: "Quantas horas você trabalha por semana?" vem com "Digite quantas horas você trabalha por semana".
  • Selo de status. Uma ou duas palavras, um estado e não uma opinião: "Atrasado 20 min", não "Está um pouquinho atrasado!".
  • Estado vazio. O que vai aparecer ali, e a única ação que preenche o espaço. Veja Estados da interface: vazio, carregando, erro, sucesso.

Cada regra deve vir com um faça e um não faça tirados do seu próprio produto. Regras abstratas recebem concordância e são ignoradas.


3. Textos são ativos do sistema

ChaveInglêsPortuguês (Brasil)Máx.Regra
ticket.action.showShow ticketVer bilhete20Começa com verbo; só a primeira letra maiúscula
ticket.status.delayedDelayed {minutes} minAtrasado {minutes} min18O número vem dos dados, nunca é digitado
ticket.status.cancelledCancelledCancelado14Nunca aparece sem uma ação ao lado
ticket.departure{time} · {duration} · {date}{time} · {duration} · {date}nenhumFormatado conforme o idioma: "Fri 4 Dec", "sex., 4 de dez."
ticket.error.loadWe couldn't load this ticketNão conseguimos carregar este bilhete40O que aconteceu, depois o que fazer
dialog.cancel.confirmCancel bookingCancelar reserva20Repete a ação; nunca "Sim" ou "OK"
Os textos do Ticket card, do jeito que o sistema guarda. Cada um tem uma chave, as traduções, um limite de tamanho com que o layout é testado, e uma regra. Quem escreve muda as palavras aqui, uma vez, e todos os produtos recebem.

Se um token é uma decisão de design com nome, um texto com chave é uma decisão de conteúdo com nome. O Harbour guarda as palavras dos seus componentes e padrões assim:

  • Uma chave que diz onde e o quê: ticket.status.delayed, não string_284.
  • As traduções, escritas por pessoas e revisadas no contexto.
  • Variáveis, não frases coladas. Atrasado {minutes} min, com o número vindo dos dados. Colar "Atrasado" + 20 + "min" no código quebra em idiomas com outra ordem de palavras.
  • Um limite de tamanho com que o layout é testado. Os textos curtos são os que mais crescem na tradução: o W3C cita os números da IBM, de 200 a 300% para textos de até 10 caracteres (W3C Internationalization, Text size in translation). É por isso que Estados e casos-limite testa cada componente com conteúdo longo e traduzido.
  • Formatos que vêm do idioma, não digitados: datas, horas, preços. O Intl.DateTimeFormat do JavaScript gera "Fri 4 Dec" em inglês britânico (en-GB) e "sex., 4 de dez." em português do Brasil (pt-BR) a partir da mesma data (MDN, Intl.DateTimeFormat).

O ganho é o mesmo dos tokens: mude as palavras uma vez e todos os produtos recebem. Quando o jurídico pede para trocar "reembolso" por "crédito", é uma mudança só, revisada uma vez.


4. Quem cuida das palavras

As palavras de um sistema precisam de alguém responsável, como os componentes. No Harbour:

  • Uma pessoa de content design no time do sistema cuida da voz, das regras de conteúdo dos componentes e dos textos compartilhados.
  • Os times de produto cuidam das palavras das próprias telas, seguindo as regras, e propõem textos compartilhados novos como qualquer contribuição (Modelos de contribuição).
  • Um guia de estilo resolve as coisas pequenas: números, datas, abreviações, maiúsculas. Você não precisa escrever um do zero: o guia de estilo de A a Z do GOV.UK é público e é um bom modelo (GOV.UK, Style guides).

Coloque o conteúdo na mesma revisão do design. Um componente não está pronto para a release enquanto as palavras dele ainda são "Lorem ipsum" ou "Botão".


5. Erros comuns

  • Uma voz escrita para o marketing, sem nada para erros ou estados vazios.
  • Piadas em erros, atrasos e problemas de pagamento.
  • Rótulos de botão que não dizem a ação: "OK", "Enviar", "Sim".
  • Textos colados no código, que quebram nas traduções.
  • Layouts testados só em inglês.
  • Regras de conteúdo que vivem na cabeça de uma pessoa, ou numa apresentação que ninguém abre.

6. Vocabulário

Termo Significado
Voz A personalidade das palavras do produto; é a mesma em todo lugar
Tom Como a voz se adapta à situação da pessoa
Regra de conteúdo Uma regra escrita para as palavras de um componente, com exemplos
Texto (string) Um trecho de texto da interface, guardado com uma chave
Limite de tamanho O comprimento máximo para o qual um layout é desenhado e testado
Locale Idioma e região juntos, como pt-BR, que definem os formatos de datas e números

7. Experimente (sem ferramentas)

  1. Junte todos os rótulos do botão principal de "seguir em frente" num produto que você conhece.
  2. Conte as palavras diferentes. Escolha a que melhor diz o que acontece, e escreva uma regra a partir dela.
  3. Encontre uma mensagem de erro e reescreva como o que aconteceu mais como resolver.

Perguntas para refletir: Se a voz do seu produto fosse três palavras, quais seriam? Que tela as quebra hoje?


8. Se você já pratica

  • Acrescente uma seção "Conteúdo" a toda página de documentação de componente: regras, faça e não faça, limites de tamanho.
  • Tire os textos compartilhados do código e coloque num arquivo com chaves, com acesso para quem escreve.
  • Teste os layouts com uma versão pseudolocalizada (texto mais longo e com acentos) antes de as traduções reais chegarem.
  • Inclua uma pessoa de content design nas revisões de componente desde o primeiro rascunho.

Checklist

Para saber mais

Livros, cursos e vídeos para ir mais fundo

Os links dos livros são de afiliado da Amazon: como associado, recebo por compras qualificadas, sem custo a mais para você.

Relacionadas

De componentes a padrões · Ícones e ilustração no sistema · Conteúdo primeiro · Componentes acessíveis · Estados e casos-limite · Estados da interface: vazio, carregando, erro, sucesso · Modelos de contribuição

Salvo só neste dispositivo.

↑ ↓ para mover · Enter para abrir · Esc para fechar