A acessibilidade começa na fonte

Um tema pode oferecer bom contraste e teclado, mas autores ainda determinam se o conteúdo é compreensível. Headings fora de ordem, links sem sentido, screenshots sem alternativas e tabelas usadas para layout não são corrigidos de forma confiável por CSS.

Regras de acessibilidade precisam estar em templates e review editorial.

Use estrutura semântica

Headings representam hierarquia, não tamanho de fonte. Listas devem ser listas e tabelas devem servir a relações tabulares reais. Use títulos descritivos e uma ordem previsível de informação.

Isso também melhora busca, navegação e reuse.

Evite “clique aqui”. O texto do link deve indicar destino ou ação. Não use apenas cor para comunicar estado ou significado.

Trate imagens como informação

Alt text comunica o que o leitor precisa extrair da imagem, não descreve cada pixel. Imagens decorativas podem ter alt vazio. Screenshots instrutivos precisam de texto próximo com a mesma ação essencial.

Diagramas complexos podem combinar alt curto e explicação longa no conteúdo.

Teste padrões de autoria

Automatize checks de alt, headings e links vazios, mas teste páginas representativas com teclado e ferramentas de acessibilidade, incluindo código, callouts, tabs e busca.

Acessibilidade escala quando os padrões seguros também são os mais fáceis de escrever.

Exemplo aplicado

Aplique “WCAG 2.2 para equipes de documentação: pontos de partida práticos” a uma página real. Escolha conteúdo com títulos, tabela, nota, exemplo, um termo repetido e pelo menos uma ação do leitor. Revise primeiro como autor e depois como alguém que não conhece o vocabulário interno.

Registre defeitos observáveis:

  • que estrutura transmite significado ausente no texto simples;
  • que termo muda de grafia ou significado;
  • que instrução depende de contexto não declarado;
  • que regra seria difícil revisar de modo consistente.

Um padrão é útil quando dois editores chegam a decisões parecidas sobre o mesmo conteúdo. Se a regra parece correta mas não pode ser demonstrada numa página representativa, refine a regra, acrescente exemplo ou reduza o escopo.

Checklist editorial rápido

  • A acessibilidade começa na fonte. Um tema pode oferecer bom contraste e teclado, mas autores ainda determinam se o conteúdo é compreensível.
  • Use estrutura semântica. Headings representam hierarquia, não tamanho de fonte.
  • Escreva links compreensíveis fora de contexto. Evite “clique aqui”. O texto do link deve indicar destino ou ação.
  • Trate imagens como informação. Alt text comunica o que o leitor precisa extrair da imagem, não descreve cada pixel.

Leituras relacionadas