Qualidade da linguagem

Terminologia e glossários.

Trate a terminologia como conteúdo governado com proprietários, status, explicações aprovadas e exceções controladas.

Esclareça a tarefa e a decisão

Este guia transforma terminologia e glossários em um fluxo de trabalho operacional revisável. Ele conecta decisões de domínio, propriedade, evidências e aceitação para que o resultado continue funcionando na produção.

Trate a terminologia como conteúdo governado com proprietários, status, explicações aprovadas e exceções controladas.

Processo prático

  1. 1

    Defina o público com evidências, incluindo experiência de leitura, contexto, dispositivo e suporte disponível.

  2. 2

    Selecione uma tarefa real e indique o que um leitor bem-sucedido deve compreender ou fazer.

  3. 3

    Crie a versão no idioma preservando todos os fatos, condições, datas e caminhos de contato relevantes para a decisão.

  4. 4

    Execute revisão especializada e editorial com critérios de aceitação registrados.

  5. 5

    Teste com membros do público-alvo, registre as descobertas, revise e aprove o lançamento.

Exemplo ou ferramenta

Um registro de glossário mostra termos preferenciais, proibidos e específicos do público com orientação CMS. Na ferramenta, registre também a linha de base, o proprietário, a decisão, as evidências, a questão em aberto e a data de aprovação. Use uma página ou transação real para que a equipe veja dependências, exceções e o trabalho de manutenção que segue o lançamento.

Ponto de decisãoRegistroCritério de aceitação
Linha de baseEstado atual observadoFonte e data registrada
DecisãoOpção selecionada e justificativaRisco e público considerados
EvidênciaTeste, documente ou meçaRevisável e específico da versão
AprovaçãoNome, função e dataTodos os critérios obrigatórios atendidos

Faça de cada termo um registro governado

Um glossário útil é mais do que uma lista de palavras preferidas. Cada registro deve conter um identificador estável, termo preferencial, variantes proibidas ou obsoletas, definição, explicação do público, formas gramaticais, exemplos, modo de idioma, domínio, proprietário, status, data de aprovação, fonte e gatilho de revisão. Mantenha a definição técnica separada do texto mostrado aos leitores. Uma definição interna precisa pode apoiar diversas explicações específicas do público, sem permitir que seus significados se desviem.

Use status explícitos: proposto, em revisão, aprovado, obsoleto e proibido. Somente registros aprovados são oferecidos aos autores ou aplicados por sistemas automatizados. Um termo obsoleto permanece pesquisável para que o conteúdo antigo possa ser encontrado e migrado. Um termo proibido inclui o motivo e a substituição aprovada, o que ajuda os editores a resolver um aviso sem adivinhação. Faça a versão de cada decisão e retenha o valor anterior para auditoria e reversão.

CampoExemploRegra de aceitação
Termo preferidoescritório de benefíciosUm formulário aprovado por domínio e modo de idioma
Explicação do públicoO escritório que verifica e paga seu benefícioSignificado preservado e testado para o público
StatusAprovadoProprietário, revisor e data de registro
ExceçãoO título do formulário oficial mantém o prazo legalEscopo, motivo e expiração são documentados

Execute um fluxo de trabalho de decisão de prazo repetível

Colete candidatos a partir de registros de pesquisa, perguntas de suporte, comentários de revisores, alterações de políticas e correções manuais repetidas. Antes de criar um novo registro, pesquise termos, variantes e conceitos relacionados existentes. O termo proprietário escreve a definição e identifica a fonte oficial. Um especialista no assunto confirma o significado, um editor propõe o texto do leitor e um especialista em acessibilidade verifica os modos de linguagem selecionados. Teste explicações de alto impacto com os leitores pretendidos.

O grupo de terminologia então aprova, rejeita ou solicita evidências. Deve reunir-se num calendário previsível e ter uma rota urgente para alterações legais ou de serviço. As decisões indicam onde o termo se aplica e onde não. Por exemplo, uma página em linguagem simples pode dizer “escritório de benefícios”, enquanto um campo de aplicação deve manter o nome da autoridade legal. A exceção pertence ao mesmo registro para que os autores vejam ambas as opções no contexto.

  1. 1

    Capture o termo candidato e o conteúdo onde causou dificuldade.

  2. 2

    Confirme o conceito, o domínio, a fonte confiável e os públicos afetados.

  3. 3

    Rascunho do texto preferido, explicação, variantes e orientações de migração.

  4. 4

    Revise o significado, o modo de linguagem, a acessibilidade e o impacto operacional.

  5. 5

    Aprove e publique o registro com versão e atualize o conteúdo afetado.

Integre a terminologia na criação e entrega

Expor o glossário através de um API ou repositório sincronizado com identificadores estáveis. O CMS deve destacar os termos proibidos e obsoletos, mostrar a substituição preferida e a explicação e permitir que os autores abram a decisão completa. As sugestões devem respeitar a localidade, o domínio, o tipo de conteúdo e o modo de idioma. Não substitua palavras automaticamente quando a gramática ou o contexto jurídico puderem mudar de significado. Exija que um autor aceite a sugestão ou registre uma exceção governada.

Armazene a versão do glossário usada para cada revisão de idioma. Quando um termo aprovado for alterado, consulte CMS em busca de registros afetados e crie tarefas de revisão por risco. As verificações de visualização podem bloquear novos termos proibidos, explicações de primeira utilização ausentes ou uma exceção expirada. A entrega em tempo de execução não deve depender de uma solicitação de glossário ativo. Resolva e valide os termos antes da publicação para que uma interrupção terminológica não possa alterar ou bloquear as páginas publicadas.

  • As sugestões CMS usam identificadores de termos estáveis ​​em vez de apenas correspondência de texto.

  • Localidade, domínio, modo de idioma e forma gramatical são respeitados.

  • As verificações automáticas explicam uma resolução em vez de apenas relatar um erro.

  • As exceções têm escopo, proprietário, evidência e expiração.

  • Uma alteração no glossário cria tarefas de revisão para o conteúdo publicado afetado.

Avalie a adoção e resolva conflitos

Rastreie o uso de termos preferenciais, novas descobertas de termos proibidos, candidatos não resolvidos, tempo médio de decisão, exceções expiradas e conteúdo aguardando migração. Combine estas medidas operacionais com evidências de compreensão e demanda de apoio. Uma alta taxa de adoção não prova que uma explicação funcione. Se os leitores ainda não entenderem um termo aprovado, reabra a decisão e preserve as evidências que motivaram a mudança.

Quando os departamentos precisarem de palavras diferentes, determine se elas significam o mesmo conceito. Se o conceito for diferente, crie registros vinculados com domínios claros. Se apenas o público for diferente, mantenha uma definição subjacente e forneça explicações separadas para o público. Designe um administrador de terminologia para decidir disputas de propriedade e evitar registros duplicados. Revise os termos de maior impacto pelo menos uma vez por ano e sempre que a lei aplicável, o processo de serviço ou o padrão do idioma selecionado mudar.

Funções, evidências e aprovação

A qualidade da linguagem é uma responsabilidade operacional. Dê ao proprietário da fonte a responsabilidade pela precisão dos fatos, ao editor a responsabilidade pela clareza, ao especialista a responsabilidade pelas regras de acessibilidade e ao proprietário do produto a responsabilidade pela publicação. O registro de liberação deve identificar a versão original, o modo de linguagem, os revisores, as evidências do teste, a data de aprovação e o evento que desencadeia uma nova revisão.

Operações e manutenção

O trabalho não termina na publicação. Vincule a versão ou configuração do idioma à sua origem, monitore medidas de qualidade e serviço e defina gatilhos de revisão concretos. Os gatilhos incluem alterações na fonte, alterações legais, novas necessidades do público, dúvidas recorrentes de suporte, alterações técnicas e incidentes. Um proprietário nomeado avalia o gatilho, abre uma nova revisão quando necessário e registra a aprovação renovada.

Lista de verificação para publicação

  • O público e a tarefa são explícitos.

  • Todos os fatos legais e operacionais correspondem à fonte.

  • Datas, valores, condições e exceções estão completos.

  • Os títulos descrevem perguntas ou ações do leitor.

  • Links e controles possuem rótulos significativos.

  • A terminologia especializada é explicada de forma consistente.

  • O público-alvo testou a jornada crítica.

  • A propriedade e o próximo gatilho de revisão são registrados.

Fontes de referência

  1. Centro Federal de Especialização em Acessibilidade - leitura fácil
  2. DIN ISO 24495-1 linguagem simples - Princípios e diretrizes governantes
  3. W3C - Tornando o conteúdo utilizável para pessoas com deficiências cognitivas e de aprendizagem

Coloque o guia em prática

Teste Simple8 com conteúdo representativo e use a lista de verificação para planejar um fluxo de trabalho de produção controlado.

Teste seu próprio texto