Skip to content

Hero da página inicial não garante contraste de texto sobre a imagem de fundo  #38

Description

@ewbenigno

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.

Screenshot_2026-07-19-12-04-09-468_com.android.chrome.jpg

IMG_20260719_120758.jpg

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions