Guia de Estilo

Um guia de estilo é um conjunto documentado de normas que regem como algo deve ser produzido, abrangendo elementos visuais, linguagem escrita ou ambos. Os guias visuais especificam tipografia, cor, espaçamento, tratamento de imagens e uso de logotipos; os guias de conteúdo especificam tom, terminologia, capitalização, convenções de formatação e como lidar com casos recorrentes, como datas, números e mensagens de erro.

Seu objetivo é tornar a consistência alcançável sem exigir que cada decisão seja rediscutida. Sem padrões documentados, cada nova página, campanha ou tela é produzida de acordo com o julgamento de quem a criou, e uma organização acumula uma dúzia de versões ligeiramente diferentes do mesmo elemento. O custo disso se manifesta na forma de incoerência visual, terminologia inconsistente que confunde os clientes e tempo gasto debatendo decisões tomadas anos atrás.

Os guias mais úteis são prescritivos e específicos, em vez de descritivos e aspiracionais. Uma afirmação de que a voz da marca é amigável, porém profissional, não oferece nenhuma orientação a alguém que esteja escrevendo uma mensagem de erro. Um guia que mostre as frases preferidas e rejeitadas para situações comuns, com a justificativa apresentada, é diretamente utilizável. O teste é se um novo colaborador conseguiria produzir um trabalho em conformidade apenas com base no documento.

As decisões sobre terminologia são frequentemente o conteúdo mais valioso e o mais negligenciado. Definir como a organização denomina cada produto, recurso e processo, e registrar as alternativas que não devem ser usadas, evita situações em que marketing, produto, suporte e documentação utilizam termos diferentes para a mesma coisa. Clientes que se deparam com três nomes para um mesmo conceito concluem, com razão, que se tratam de três coisas diferentes.

Os guias falham principalmente pela falta de aplicação, e não por conteúdo ruim. Um documento que é escrito, divulgado e nunca mais consultado é rapidamente suplantado por práticas inconsistentes, e a versão que as pessoas de fato seguem passa a ser aquela que foi apresentada no último documento similar. Mecanismos de aplicação eficazes incluem a incorporação de regras em ferramentas, como a verificação de padrões de conteúdo (linting), e a restrição de escolhas em bibliotecas de design e componentes, o que torna a conformidade o caminho de menor resistência.

A manutenção determina se o guia permanece válido. Normas que não refletem mais as práticas atuais são ignoradas seletivamente, e a conformidade seletiva se transforma em não conformidade generalizada. Atribuir responsabilidades, fornecer um canal para propor mudanças e revisar periodicamente mantém o documento atualizado, e registrar o raciocínio por trás das decisões impede que elas sejam revertidas levianamente por alguém que desconhece os motivos que as levaram a tomar decisões.

O escopo deve corresponder ao que a organização pode realisticamente manter. Guias abrangentes que cobrem todos os casos imagináveis ​​tornam-se tão extensos que ninguém os lê e tão obsoletos que ninguém confia neles. Um guia conciso que aborde as decisões que de fato se repetem, expandindo-se apenas quando uma ambiguidade genuína surge repetidamente, permanece atualizado e em uso, e a disciplina de não documentar casos raros é o que o mantém assim.

É importante distinguir a relação com um sistema de design. Um guia de estilo documenta decisões e regras; um sistema de design fornece componentes implementados que as incorporam. Um guia, por si só, depende da leitura e aplicação por parte das pessoas, enquanto os componentes impõem o padrão automaticamente onde quer que sejam usados. Quando ambos existem, o guia abrange o que os componentes não conseguem, incluindo tom, terminologia e decisões que exigem julgamento.

Como o valor advém da adoção e não da documentação, o esforço despendido em mecanismos de aplicação geralmente traz mais retorno do que o esforço despendido na extensão do guia. Na prática, os padrões visuais e de componentes são estabelecidos dentro design de produto e codificados no sistema de design, os padrões de linguagem e terminologia são acordados com serviços de marketing para que o vocabulário voltado para o cliente seja consistente em todo o produto e sua promoção, e a propriedade geralmente permaneça com o Departamento de UX onde houver um.