SEO

O Docsbook cria para você a metade legível por máquinas da sua documentação. Cada página que ele hospeda é um HTML renderizado no servidor que contém um <title> resolvido, uma descrição meta limpa, uma URL canônica, um conjunto de hreflang que contém apenas os idiomas para os quais você realmente traduziu, cartões OpenGraph e X com uma imagem gerada, um grafo JSON-LD e uma entrada em um sitemap para a qual robots.txt aponta. Você escreve em Markdown; o cabeçalho é uma consequência.

Esta seção aborda os resultados de pesquisa — o que o Google e o Bing rastreiam, indexam e classificam. Dois vizinhos abrangem as outras superfícies de máquina e não se sobrepõem a ela: AEO é a caixa de resposta acima dos resultados, e GEO é ser citado por um assistente de IA em vez de ser classificado.

O que isso lhe custa#

Três coisas, e uma delas não é opcional.

1. Ative a opção de SEO. No painel de administração, Configurações ▸ SEO & GEO, a SEO alternância. Ela fica desativada em um projeto novo e, enquanto está desativada, todas as páginas são servidas noindex, nofollow — a marcação é toda gerada, e tudo nela diz "não me indexe". Esse é o motivo mais comum para um site Docsbook não aparecer no Google. É gratuito em todos os planos.
2. Escreva um # H1 claro e um parágrafo de abertura que responda à pergunta da página. Eles se tornam o título e a descrição, a menos que você os substitua.
3. Nada mais. URLs canônicas, o mapa do site, robots.txt, cards, JSON-LD e o agrupamento de idiomas são gerenciados, e não há uma superfície de configuração para eles.

Para substituir a linha gerada em uma página, coloque-a no frontmatter:

---
title: "Configure a webhook"
description: "Register a Docsbook webhook, choose its events, and verify the first delivery."
---

Para manter uma página fora do índice enquanto ela continua publicada e legível:

---
noindex: true
---

robots: noindex, noindex: yes e noindex: 1 também são aceitos. Use-os em páginas que consomem orçamento de rastreamento sem jamais gerar um clique — um changelog de 90.000 caracteres, anotações internas de trabalho, um espaço reservado inacabado. A opção para todo o site é o instrumento errado para isso: desativá-la oculta tudo.

Os sinais e onde cada um é decidido#

Por que esta é a maneira certa (evidências)#

O que o Docsbook não afirmará#

• Nada disso faz uma página obter uma classificação. Todos os mecanismos acima tornam uma página rastreável, inequívoca e apresentada corretamente. O FAQ sobre experiência da página do Google responde à pergunta "Existe um único 'sinal de experiência da página'…?" com "Não existe um único sinal", e responde sobre quanto a experiência da página importa para a classificação com "A Pesquisa Google sempre busca mostrar o conteúdo mais relevante, mesmo que a experiência da página seja inferior" (Experiência da página). A marcação é o ponto de partida, não a alavanca.
• Os dados estruturados são documentados como um sinal de elegibilidade, não de classificação. A própria introdução do Google fala sobre resultados avançados e não diz nada sobre classificação.
• priority e changefreq no sitemap não fazem nada pelo Google. "O Google ignora os valores <priority> e <changefreq>." O Docsbook os gera para os mecanismos que de fato os leem.
• O orçamento de rastreamento provavelmente não é o seu problema. O guia de orçamento de rastreamento do Google é destinado a "Sites grandes (1 milhão ou mais de páginas exclusivas) com conteúdo que muda com frequência moderada (uma vez por semana)" e "Sites médios ou maiores (10.000 ou mais páginas exclusivas) com conteúdo que muda muito rapidamente (diariamente)" — e afirma, na mesma frase, que estes "são uma estimativa aproximada para ajudar você a classificar seu site. Estes não são limites exatos." noindex em um changelog enorme ainda vale a pena; tratar um site de documentação com 60 páginas como uma emergência de orçamento de rastreamento não vale.
• Nenhum multiplicador. O tráfego depende do seu tópico, da sua concorrência e do seu domínio. Qualquer plataforma que cite uma porcentagem está citando o site de outra pessoa.

Limites#

• A configuração em todo o site vem desativada por padrão e se aplica a todo o workspace. Não há um controle para “indexar esta seção, mas não aquela” acima da flag noindex por página.
• Em um domínio personalizado, a configuração de SEO e noindex por página não são respeitadas — as páginas são servidas index, follow incondicionalmente — e não há cluster hreflang, nem BreadcrumbList, nem sitemap, nem redirecionamento de página movida e nenhum dos sinais de nível de página de GEO. A URL canônica, o título, a descrição, os cards e o nó TechArticle estão todos corretos nesse caso. Consulte Como funciona.
• As posições do Search Console abrangem apenas hosts hospedados pelo Docsbook. Um site em seu próprio domínio está fora da propriedade que o Docsbook lê. Consulte Indexação.
• Uma renomeação fora do Docsbook não deixa nenhum redirecionamento. As mudanças feitas pelo Docsbook criam um automaticamente; uma git mv não.

Lista de verificação#

• A alternância SEO está ativada em Configurações ▸ SEO & GEO.
• Cada página tem um # H1 claro ou um title no frontmatter.
• O parágrafo inicial responde à pergunta da página em uma ou duas frases.
• Todas as páginas podem ser acessadas pela barra lateral; não há páginas órfãs.
• As páginas que nunca devem ser classificadas têm noindex: true.
• Para documentação multilíngue, as traduções estão ativadas para que cada idioma tenha sua própria URL indexável.

Relacionados#

• Como o Docsbook cria o cabeçalho de uma página — as ordens de resolução.
• Indexação — descoberta, novo rastreamento e Search Console.
• AEO — mecanismos de resposta e resultados avançados
• GEO — citações por assistentes de IA
• llms.txt
• Traduções por IA
• Opções de pesquisa — a pesquisa no site que os leitores usam quando chegam.