Mantém a média de palavras por frase abaixo de 20

O que esta verificação faz

Soma cada palavra da página e divide pelo número de frases. O resultado é a média de palavras por frase. A verificação falha acima de 20.

Esta é a verificação companheira de Frases longas — essa olha para a cauda longa, esta olha para a média. Podes falhar uma sem falhar a outra.

Porque é importante

O comprimento das frases é o maior botão na velocidade de leitura, em todas as escalas de medição alguma vez publicadas:

• Diretrizes de plain-language (federal dos EUA, UE) apontam para uma média de 15–20 palavras.
• Hemingway Editor sinaliza páginas em que a frase média é “difícil de ler” — o limiar ronda as 21 palavras.
• Yoast SEO fixa o corte de “bom” em 20.
• Ecrãs móveis envolvem uma frase de 22 palavras em cerca de quatro linhas a 16px / 360px. Quatro linhas é o limiar a partir do qual estudos de eye-tracking veem o comportamento de skimming substituir a leitura.

A regra não é que todas as frases tenham de ser curtas — é que a média tem de ser conversacional. Varia o ritmo: um remate de 5 palavras depois de uma preparação de 25 palavras é boa prosa. Uma página inteira de frases de 25 palavras é exaustiva.

Como corrigir

A correção é idêntica a Frases longas: encontra as frases mais longas e divide-as. Como isto é uma média, mesmo cortar o top 10% de frases puxa a média para baixo de forma significativa.

Padrão: divide com pontos, não vírgulas. A maioria das frases demasiado longas são duas ou três frases reais coladas com vírgulas ou “e”:

Antes (28 palavras):
Reescrevemos o motor de auditoria em TypeScript durante o verão, o que nos
permitiu abandonar a stack legada em PHB por completo, e agora corremos
tudo num único processo Bun.

Depois (10 + 9 + 7):
Reescrevemos o motor de auditoria em TypeScript durante o verão. A stack
legada em PHP desapareceu. Tudo corre agora num único processo Bun.

Padrão: introduz variedade. Uma página de frases uniformes de 19 palavras passa tecnicamente mas parece mecânica. Mistura:

Lançamos todas as sextas. O deploy leva nove minutos — cerca de metade é
o build do Astro, que ainda não otimizámos. Depois fica no ar.

Quatro frases: 4 palavras, 22 palavras, 10 palavras, 2 palavras. Média: 9,5. Lê-se com naturalidade.

Padrão: corta enchimento. A maioria das frases longas tem um quinto das palavras a não fazer nada:

Antes (24 palavras):
É importante notar que a integração com o GA4 atualmente só suporta
propriedades que tenham sido ligadas através do fluxo explícito de ligação por site.

Depois (12 palavras):
O GA4 só funciona para propriedades ligadas pelo fluxo de ligação por site.

“É importante notar que”, “o facto de que”, “por forma a”, “neste momento”, “devido ao facto de” — procura e apaga.

Padrão: converte em listas. Três orações coordenadas numa frase quase sempre leem-se melhor em bullets. Vê o exemplo na página Frases longas.

Ferramentas. Iguais às da página de frases longas: Hemingway, Yoast, textstat, estatísticas de legibilidade do MS Word. Para CI, falha builds quando a média passa de 20:

import textstat from "textstat";

const avg = textstat.avgSentenceLength(pageBody);
if (avg > 20) throw new Error(`Avg sentence length ${avg} > 20`);

Perguntas frequentes

A minha página é referência técnica — preciso mesmo de estar a 20?

Páginas de referência técnica são uma exceção. Docs de API, descrições de schema e páginas man de linha de comandos podem legitimamente ter médias mais altas porque priorizam a precisão sobre o fluxo. Para páginas de marketing, posts de blog, copy de produto, artigos de suporte e fluxos de onboarding, a regra das 20 palavras é a certa.

Qual é um bom alvo se 20 é o teto?

15–18 palavras de média é o ponto certo. As diretrizes de plain-language dizem “cerca de 15”; a maioria dos posts de blog profissionalmente editados aterra entre 16–18. Abaixo de 10 começa a soar staccato, a não ser que andes mesmo à procura dessa voz.

Variar o comprimento importa, ou só a média?

Ambos. A média é o que a verificação mede, mas o ritmo importa em separado — uma página onde cada frase tem exatamente 17 palavras lê-se pior do que uma com 8/22/12/4/19. Varia os comprimentos e a média trata-se a si própria.