Feedback da página
O feedback da página no Docsbook é um controle Esta página foi útil? que o leitor responde com um clique — sem formulário, sem endereço de e-mail — e a resposta chega às suas análises associada àquela página. Ele contabiliza um voto por visualização da página: após votar, os botões são bloqueados e um breve agradecimento substitui a pergunta.
Onde o feedback da página pode aparecer#
O feedback da página tem dois controles independentes, porque eles alcançam os leitores em momentos diferentes.
| Abaixo da página | No painel "Nesta página" | |
|---|---|---|
| Onde | No final do artigo, acima dos links anterior/próximo | No índice à direita, abaixo do sumário |
| Configuração | Avaliar esta página (aba Conteúdo) | Avaliar página (aba Barra lateral direita) |
| Padrão | Ativado | Desativado |
| Em um celular | Exibido | Não exibido — o painel à direita não é renderizado em telas estreitas |
A barra abaixo da página é a que a maioria dos projetos quer ativar: os leitores chegam até ela ao terminar a página, que é o momento em que já têm uma opinião, e ela é a única que os leitores no celular conseguem ver. Ativar ambas coleta uma única série combinada — são dois lugares separados para fazer a pergunta, não métricas separadas.
Ativar feedback da página#
Abaixo da página (ativado por padrão):
- Abra seu site de documentação enquanto estiver conectado.
- Abra Float Widget → Configurações → aba Conteúdo.
- Ative Avaliar esta página.
No painel "Nesta página":
- Abra Float Widget → Configurações → aba Barra lateral direita.
- Ative Avaliar página.
Leia os resultados#
Abra o Float Widget → aba Análises e role até a seção Feedback. Ela mostra:
- Contagens totais de avaliações positivas e negativas em todo o site
- Uma análise detalhada por página, para que você possa ordenar as páginas com as piores avaliações dos leitores
Aja de acordo com o que as avaliações dizem#
| Sinal | O que fazer |
|---|---|
| Predominantemente avaliações negativas | Reescreva para maior clareza, adicione um exemplo ou divida a página em duas |
| Predominantemente avaliações positivas | Reutilize sua estrutura como modelo para novas páginas |
| Nenhuma avaliação | Verifique se a página recebe tráfego em Web analytics antes de reescrevê-la |
O feedback é mais informativo em páginas instrucionais — tutoriais e guias práticos — nas quais o leitor concluiu ou não a tarefa. Em páginas de referência, como tabelas de parâmetros, uma avaliação informa pouco.
A coleta de uma avaliação não chama nenhum modelo de IA, portanto o feedback da página não consome o saldo do seu projeto.
Próximos passos#
- Análise da web — associe uma avaliação baixa ao tráfego que a página recebe antes de decidir reescrevê-la.
- Pesquisa de texto completo — pesquisas sem resultados são outro sinal de que uma página está ausente ou tem um nome incorreto.
Todo projeto novo começa com US$ 1 de saldo, e o feedback das páginas não o utiliza.