Descrição:
O hero da página /pages/start/welcome usa uma backgroundImage com
texto sobreposto (título em branco, parágrafo em cinza claro/opacidade),
mas não há overlay/gradiente escuro fixo entre a imagem e o texto.
Isso já causa um problema visível hoje: onde o parágrafo de introdução
cruza a faixa mais clara (verde) da imagem de fundo, o contraste cai
sensivelmente em relação ao trecho sobre o fundo preto (ver screenshots
em anexo, Print 1: contexto geral do hero; Print 2: zoom nas linhas
finais do parágrafo, onde a perda de contraste é mais evidente).
Por que isso precisa ser corrigido:
- É a primeira página que qualquer desenvolvedor vê ao acessar a
documentação, um problema de legibilidade logo no topo passa uma
impressão de descuido, especialmente numa doc voltada para devs atentos a detalhes técnicos.
- Contraste insuficiente fere a diretriz WCAG 2.1 (nível AA, critério 1.4.3), que exige razão mínima de 4.5:1 entre texto e fundo, texto sobre a faixa verde provavelmente não atinge esse mínimo.
- Afeta ainda mais usuários com baixa visão, e piora em telas de celular sob luz solar direta, onde o brilho reduz o contraste percebido ainda mais.
- Como a imagem de fundo pode ser trocada no futuro (nova arte, campanha, etc.), corrigir com um overlay fixo resolve o problema de forma permanente, em vez de depender de a próxima imagem
"calhar" de ser escura o suficiente.
Sugestão de correção:
Adicionar um gradiente escuro fixo entre a imagem e o texto, por exemplo:
background: linear-gradient(rgba(0,0,0,0.5), rgba(0,0,0,0.5)), url('...');
Isso garante contraste mínimo independente das áreas claras/escuras
da imagem de fundo.


Posso trabalhar nessa correção! Um overlay/gradiente escuro sobre o
background do hero resolveria. Fico no aguardo de aprovação antes de
abrir o PR.
Descrição:
O hero da página
/pages/start/welcomeusa umabackgroundImagecomtexto sobreposto (título em branco, parágrafo em cinza claro/opacidade),
mas não há overlay/gradiente escuro fixo entre a imagem e o texto.
Isso já causa um problema visível hoje: onde o parágrafo de introdução
cruza a faixa mais clara (verde) da imagem de fundo, o contraste cai
sensivelmente em relação ao trecho sobre o fundo preto (ver screenshots
em anexo, Print 1: contexto geral do hero; Print 2: zoom nas linhas
finais do parágrafo, onde a perda de contraste é mais evidente).
Por que isso precisa ser corrigido:
documentação, um problema de legibilidade logo no topo passa uma
impressão de descuido, especialmente numa doc voltada para devs atentos a detalhes técnicos.
"calhar" de ser escura o suficiente.
Sugestão de correção:
Adicionar um gradiente escuro fixo entre a imagem e o texto, por exemplo:
background: linear-gradient(rgba(0,0,0,0.5), rgba(0,0,0,0.5)), url('...');
Isso garante contraste mínimo independente das áreas claras/escuras
da imagem de fundo.
Posso trabalhar nessa correção! Um overlay/gradiente escuro sobre o
background do hero resolveria. Fico no aguardo de aprovação antes de
abrir o PR.