Diretrizes de Marca

Escreva textos voltados para o usuário seguindo as diretrizes de marca do Sentry.

Quando Usar

• Você precisa escrever ou reescrever textos voltados para o usuário na voz do Sentry.
• A tarefa envolve texto de interface, onboarding, estados vazios, documentação, textos de marketing ou outro conteúdo de marca.
• Você precisa de orientação sobre quando usar Linguagem Clara versus Voz do Sentry.

Seleção de Tom

Escolha o tom apropriado com base no contexto:

Use Linguagem Clara por padrão, a menos que o contexto exija especificamente personalidade.

Linguagem Clara (Padrão)

Linguagem Clara é clara, direta e funcional. Use-a para a maioria dos elementos da UI.

Regras

1. Seja conciso - Use o mínimo de palavras necessárias
2. Seja direto - Diga aos usuários o que fazer, não o que eles podem fazer
3. Use voz ativa - "Salve suas alterações" em vez de "Suas alterações serão salvas"
4. Evite jargões - Use palavras simples que os usuários entendam
5. Seja específico - "3 erros encontrados" em vez de "Alguns erros encontrados"

Exemplos

Voz do Sentry

A Voz do Sentry adiciona personalidade em momentos apropriados. É empática, autoconsciente e ocasionalmente sarcástica.

Princípios

1. Sarcasmo empático - Direcione a frustração para a situação, nunca para o usuário
2. Autoconsciente - Reconheça o absurdo do software
3. Divertido, mas funcional - A personalidade deve aprimorar, não obscurecer o significado
4. Momentos merecidos - Use apenas quando os usuários tiverem tempo para apreciar

Exemplos

Páginas 404:

"Esta página não existe. Talvez nunca tenha existido. Talvez tenha sido um sonho. De qualquer forma, vamos te colocar de volta nos trilhos."

Estados Vazios:

"Ainda não há erros. Aproveite este momento de paz enquanto ele dura."

Onboarding:

"Vamos capturar seu primeiro erro. Não se preocupe, não é tão assustador quanto parece."

Estados de Carregamento:

"Calculando os números..." "Buscando seus dados..."

Quando NÃO Usar a Voz do Sentry

• Mensagens de erro (usuários estão frustrados)
• Páginas de configurações (usuários estão focados)
• Documentação (usuários precisam de informações)
• Fluxos de faturamento/pagamento (usuários precisam de confiança)

Regras Gerais

Ortografia e Gramática

• Use a ortografia do Inglês Americano (color, não colour)
• Use Title Case para títulos e títulos de página
• Use Sentence case para texto corrido, botões e rótulos

Pontuação

• Sem pontos de exclamação em textos de UI (exceção: momentos de celebração)
• Sem pontos finais em rótulos curtos de UI ou texto de botões
• Use pontos finais em frases completas e texto de ajuda
• Sem CAIXA ALTA exceto para acrônimos (API, SDK, URL)

Escolhas de Palavras

Uso de Travessões

Na maioria dos contextos de UI, use hifens. Reserve travessões curtos para intervalos de datas e travessões longos para textos mais extensos.

Diretrizes de Elementos de UI

Botões

• Use verbos de ação: "Salvar", "Excluir", "Criar"
• Seja específico: "Criar Projeto" em vez de apenas "Criar"
• Máximo de 2-3 palavras, quando possível
• Sem pontos finais ou pontos de exclamação

Mensagens de Erro

1. Diga o que aconteceu
2. Diga por quê (se for útil)
3. Diga o que fazer em seguida

Bom: "Não foi possível salvar as alterações. Verifique sua conexão e tente novamente." Ruim: "Erro: Falha ao salvar."

Estados Vazios

1. Explique o que normalmente estaria aqui
2. Forneça uma ação clara para preencher o estado
3. A Voz do Sentry é apropriada aqui

Bom: "Ainda não há projetos. Crie seu primeiro projeto para começar a rastrear erros."

Diálogos de Confirmação

• Deixe a ação clara no título
• Explique as consequências se for destrutivo
• Use rótulos de botão específicos ("Excluir Projeto", não "OK")

…