Página que responde a busca no primeiro parágrafo: como reescrever a sua

A página "Erro 413 no nginx" do blog Oficina do Código tinha 1.800 palavras. Começava com a história do protocolo HTTP, passava pela tabela de códigos de status e só no quarto bloco dizia qual linha mudar. No Search Console, ela aparecia bastante e recebia pouquíssimos cliques, e quem clicava saía rápido. A resposta curta: a página que segura quem veio da busca responde a pergunta no primeiro parágrafo, em duas ou três frases, com a ação concreta. O título repete a dúvida com as palavras da pessoa, o começo resolve, e o resto da página explica o porquê e os cuidados para quem quiser ficar.

Este guia mostra como reescrever o começo de uma página existente, usando essa página do erro 413 como exemplo do início ao fim. Ele parte do pressuposto de que você já sabe que a frase pede um texto explicativo; se ainda não sabe, comece por intenção da busca antes do volume.

Por que a resposta tem de vir antes

Quem chega pela busca tem uma pergunta específica e uma lista de alternativas a um clique de distância. Ele não lê a página de cima a baixo: bate o olho no título, no primeiro parágrafo e nos subtítulos. Se não encontra sinal de resposta em poucos segundos, volta e tenta o próximo resultado.

Esse comportamento tem consequência dupla. Para a pessoa, a página falhou. Para você, a visita virou uma saída imediata, e a página perdeu a chance de mostrar o resto do conteúdo, que talvez fosse ótimo. Tamanho não é sinal de qualidade; resolver a dúvida é.

Há ainda um efeito na própria busca. O buscador às vezes exibe um trecho da página que responde diretamente à pergunta. Não há como garantir que isso aconteça, mas um parágrafo curto, claro e logo no começo é exatamente o tipo de texto que pode ser usado assim. Introdução genérica sobre a história do HTTP nunca será.

A estrutura de uma página que responde

1. Título com a dúvida da pessoa. Do jeito que ela digita, não do jeito que o especialista nomeia. O título de cada página deve ser único, como explica cada página tem um title único, que parece a busca da pessoa.
2. Primeiro parágrafo com a resposta. Duas ou três frases. A ação concreta, o comando, o número, a regra. Quem ler só isso sai com o problema resolvido ou sabendo o próximo passo.
3. Por que acontece. O mecanismo, para quem quer entender e não repetir o erro.
4. Como fazer, passo a passo. Com o exemplo real: código, configuração, comando com a saída esperada.
5. Cuidados e variações. O que muda em outro ambiente, o que pode dar errado, como conferir.
6. Ligação com o próximo problema. Links para o assunto vizinho que a pessoa provavelmente vai encontrar depois.

O exemplo: reescrevendo a página do erro 413

Antes

Título: "Entendendo os códigos de status HTTP: o caso do 413". Primeiro parágrafo:

O protocolo HTTP foi criado no início dos anos 1990 e, desde então, evoluiu muito. Os códigos de status são uma parte fundamental dessa comunicação entre cliente e servidor, e conhecê-los é essencial para qualquer desenvolvedor web.

Nada aí é falso, e nada ajuda quem acabou de ver o upload falhar. A frase "erro 413" nem aparece no título com as palavras que a pessoa usou.

Depois

Título: "Erro 413 Request Entity Too Large no nginx: como aumentar o limite de upload". Primeiro parágrafo:

O erro 413 aparece quando o corpo do pedido passa do limite do nginx, que por padrão é de 1 MB. Aumente a diretiva client_max_body_size no bloco http, server ou location do site, teste a configuração com nginx -t e recarregue. Se a aplicação é PHP, confira também os limites de upload do próprio PHP, que vêm logo em seguida.

Em três frases, a pessoa sabe a causa, a diretiva, onde colocar e o que conferir depois. O resto da página vem com o exemplo de configuração:

# /etc/nginx/sites-available/oficinadocodigo.conf
server {
    listen 443 ssl;
    server_name oficinadocodigo.com.br;

    # limite para envio de arquivos até 20 MB
    client_max_body_size 20m;

    # ... restante da configuração
}

$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful
$ sudo systemctl reload nginx

Depois disso, a página explica por que o limite existe (proteger o servidor de pedidos gigantes), mostra como colocar o limite maior só na rota de upload em vez do site todo e linka o guia de upload de arquivo em PHP, onde estão os limites da outra ponta. A história do HTTP saiu inteira. Ninguém sentiu falta.

O esqueleto em HTML

A estrutura acima, em marcação, fica assim. Repare que a resposta é um parágrafo comum, logo depois do título, sem acordeão nem botão de "leia mais" na frente:

<article>
  <h1>Erro 413 Request Entity Too Large no nginx: como aumentar o limite de upload</h1>
  <p>O erro 413 aparece quando o corpo do pedido passa do limite do nginx...</p>

  <h2>Por que o nginx recusa o arquivo</h2>
  <p>...</p>

  <h2>Como aumentar o client_max_body_size</h2>
  <pre><code>...</code></pre>

  <h2>Erro 413 com PHP: os limites do outro lado</h2>
  <p>...</p>
</article>

A descrição da página, na meta tag description, pode resumir a mesma resposta; o guia meta tags que o Google realmente lê mostra como.

Como testar se o começo responde

O teste é simples e não precisa de ferramenta. Cubra a página inteira menos o título e o primeiro parágrafo. Leia como se você fosse a pessoa com o erro na tela. A dúvida morreu, ou pelo menos você sabe exatamente o que fazer a seguir? Se a resposta é não, o texto ainda está se apresentando.

Depois de publicar, acompanhe no Search Console as consultas que levam à página. Elas mostram as perguntas reais, que às vezes são diferentes da que você imaginou. Se aparece muito "erro 413 cloudflare", talvez o começo precise de uma frase sobre isso, ou uma página separada. E leia os números com calma: o Search Console mostra como a busca viu o site, não uma nota.

Erros comuns

• Começar com definição de dicionário. "O HTTP é um protocolo..." empurra a resposta para baixo e a pessoa sai antes de chegar.
• Título com o nome técnico em vez da dúvida. Ninguém busca "considerações sobre limites de corpo de requisição".
• Repetir a palavra-chave até perder o sentido. O texto fica estranho para quem lê e não ajuda em nada na busca.
• Esconder a resposta atrás de clique. Acordeão, aba ou "continue lendo" antes da solução fazem a pessoa trabalhar para achar o que veio buscar.
• Prometer no título o que a página não entrega. A pessoa volta para a busca, e a desconfiança fica com a sua marca.
• Responder a pergunta errada. Se a busca era preço e você escreve um ensaio, nenhuma reescrita do primeiro parágrafo resolve; o formato é que está errado.

Checklist

• O título usa as palavras que a pessoa digitaria.
• O primeiro parágrafo tem a resposta em até três frases.
• A resposta inclui a ação concreta: comando, diretiva, número ou regra.
• Os subtítulos dizem o que cada seção entrega.
• Há pelo menos um exemplo real com a saída esperada.
• Nenhuma introdução genérica vem antes da resposta.
• As consultas reais da página foram conferidas no Search Console depois da publicação.

Abra a página do seu site que mais recebe visitas da busca, cubra tudo menos o título e o primeiro parágrafo e leia como um estranho com pressa. A dúvida dele morreu ali, ou ele ainda teria de rolar?