Imagem gerada por IA pelo ChatGPT
Acabámos de concluir uma renovação completa dos nossos guias de validação HTML e acessibilidade — mais de 750 deles. Cada guia foi revisto, corrigido e expandido para lhe fornecer explicações mais claras, melhores exemplos de código e passos práticos para corrigir cada problema.
Estes não são apenas pequenos ajustes. Voltámos aos fundamentos e perguntámos: se um programador ou engenheiro de QA encontrar este problema pela primeira vez, este guia vai realmente ajudá-lo a corrigi-lo? Se a resposta fosse “não exatamente”, reescrevemo-lo.
Aqui está o que mudou:
Explicações mais claras do que cada problema significa e por que é importante. Não apenas a definição técnica — o impacto real nos utilizadores. Por que um atributo lang em falta não é um detalhe insignificante, mas uma barreira para leitores de ecrã. Por que IDs duplicados podem silenciosamente quebrar interações de formulários. Cada guia agora conecta a regra às pessoas que ela protege.
Exemplos práticos de código que pode adaptar imediatamente. Cada guia inclui fragmentos de código antes-e-depois que mostram o padrão problemático e a sua versão corrigida. Não precisa mais de adivinhar como “garantir contraste adequado” realmente se parece no seu markup.
Cobertura para cada problema que o Rocket Validator consegue detetar. Problemas de validação HTML e violações de acessibilidade WCAG — se aparecer no seu relatório, há um guia pronto para o orientar através da correção.
Construído para humanos, não apenas validadores
Uma coisa que ouvimos constantemente dos utilizadores foi que os guias de validação tendem a ser escritos para pessoas que já compreendem a especificação. Isso está ao contrário. As pessoas que mais precisam de guias são aquelas que encontram um problema pela primeira vez.
Por isso, reescrevemos com essa audiência em mente. Um programador júnior que vê aria-hidden="true" num elemento focalizável pela primeira vez encontrará um guia que explica o que é ARIA, por que esta combinação é um problema e exatamente como corrigi-lo — sem assumir que memorizou a especificação WAI-ARIA.
Ao mesmo tempo, os programadores experientes também obtêm o que precisam: descrições concisas de problemas, correções diretas de código e links para as especificações relevantes para contexto mais profundo.
Diga-nos o que pensa — diretamente do guia
Também adicionámos algo que devíamos ter construído há muito tempo: um widget de feedback em cada guia.
No final de cada página de guia, encontrará uma forma rápida de nos dizer se o guia foi útil, se algo não estava claro ou se pensa que precisa de melhorias. Leva apenas alguns segundos. Não é necessário login.
Isto é importante para nós. Com mais de 750 guias para manter, o seu feedback é a forma mais rápida de encontrarmos o que está a funcionar e o que ainda precisa de atenção. Encontrou um exemplo de código que não se aplica exatamente ao seu framework? Diga-nos. Pensa que uma explicação poderia ser mais clara? Conte-nos. Quer que um guia cubra um caso extremo que atualmente não cobre? Queremos ouvir.
Lemos cada pedaço de feedback e usamo-lo para continuar a melhorar os guias ao longo do tempo.
Melhores guias, melhores conversas MCP
Se está a usar a nossa integração MCP Server com o Claude, esta atualização torna os seus fluxos de trabalho assistidos por IA ainda mais poderosos. Quando o Claude recupera um guia para o ajudar a corrigir um problema, está agora a extrair de uma base de conhecimento mais rica, mais precisa e mais detalhada. Melhores guias significam melhores respostas.
Pergunte ao Claude “como corrijo este problema de contraste?” e a resposta será baseada num guia que foi cuidadosamente revisto para precisão e completude.
Comece a explorar
Pode navegar pela coleção completa de guias agora mesmo:
- Guias de validação de acessibilidade — regras baseadas em WCAG que cobrem tudo, desde texto alternativo e atributos ARIA até navegação por teclado e contraste de cores.
- Guias de validação HTML — regras HTML baseadas em normas que cobrem estrutura de documento, aninhamento de elementos, uso de atributos e muito mais.
E quando encontrar um guia que ajuda, clique no botão de feedback no final da página — isso ajuda-nos a saber o que está a funcionar e onde nos devemos concentrar a seguir.