Inclusão e acessibilidade

O compromisso

Uma publicação do TheDocs é um documento para ser lido, e ler não deveria depender de enxergar bem, de usar mouse ou de aguentar movimento na tela. Tratamos barreira de leitura como defeito do produto, e não como pedido especial.

O que existe hoje

• Ouvir o texto

  Toda publicação do TheDocs tem o botão Ouvir, no topo. Ele lê o título, o autor e o texto em voz alta, com pausar, continuar, parar e velocidade de 0,75× a 2×. O trecho lido fica destacado e a página acompanha a leitura. Usa a voz do próprio navegador: o texto não passa por servidor da The Canteiro.

• Teclado

  Tudo o que é botão ou link se alcança com Tab e se aciona com Enter ou Espaço, com contorno de foco visível. No Ouvir, Alt+Shift+O começa ou pausa a leitura e Esc, com o foco na barra, para. Nenhuma tecla de uma letra só é capturada, para não colidir com os atalhos dos leitores de tela.

• Leitor de tela

  As publicações usam marcação semântica: um título principal, seções em títulos de segundo e terceiro nível, listas e citações de verdade, e um sumário navegável. A capa só é aceita com descrição, e as imagens do texto têm campo de descrição. O estado do Ouvir é anunciado em uma região discreta, só quando muda.

• Contraste e cor

  O texto secundário usa uma cor escolhida para passar de 7:1 sobre o fundo, e o trecho lido se distingue por uma barra lateral além da cor. Em modo de cores forçadas do sistema, o destaque vira contorno.

• Movimento reduzido

  Quem pede menos movimento ao sistema (prefers-reduced-motion) não vê as transições do sumário, da gaveta de compartilhar nem da barra do Ouvir, e a página acompanha a leitura sem rolar suavemente.

• Zoom e telas pequenas

  A leitura se adapta a telas estreitas, a partir de 375 px, sem rolagem horizontal na página.

O que ainda não existe

Para não prometer o que não entregamos, estes são os limites de hoje:

• Sem auditoria externa

  Nenhuma pessoa ou empresa independente avaliou o TheDocs. Não afirmamos conformidade com a WCAG nem com a LBI.

• Testes parciais com leitor de tela

  A marcação segue boas práticas, mas ainda não há uma bateria regular de testes com NVDA, JAWS, VoiceOver e TalkBack.

• A voz depende do aparelho

  A qualidade do Ouvir é a da voz instalada. Sem uma voz em português no aparelho, o navegador escolhe a dele, e alguns navegadores usam vozes em nuvem, caso em que o texto é processado pelo fornecedor do navegador. O Ouvir também não funciona em navegadores sem síntese de voz: nesses, o botão não aparece.

• Ouvir só nas publicações

  Ainda não há Ouvir nas páginas de documentação, no acervo nem na página de cada autor. Também não há áudio gravado por pessoas.

• Sem tema próprio de alto contraste

  Não há seletor de tema nem de tamanho de letra no TheDocs; usamos o que o navegador e o sistema já oferecem.

• Texto de quem publica

  O que cada autor escreve é responsabilidade do autor. Ainda não avisamos, por exemplo, quando uma imagem foi publicada com a descrição em branco.

Relate uma barreira

Encontrou algo que atrapalhou a leitura? Escreva para suporte@thecanteiro.com.br com o assunto "Acessibilidade", o endereço da página, o que tentou fazer e o que aconteceu. Se puder, diga o navegador e a tecnologia assistiva que usa. Também aceitamos o relato por outra forma de contato, se o e-mail for a barreira: diga qual prefere.

A resposta segue o prazo do suporte (ver Suporte e contato). Relatos de barreira entram na fila de correção do produto.