Como o Docsbook comprova o que afirma
As plataformas de documentação são vendidas com adjetivos — avançadas, inteligentes, otimizadas. Adjetivos não podem ser refutados, portanto não transmitem nenhuma informação. Em vez disso, esta documentação é escrita de acordo com uma regra: uma página sobre uma capacidade deve permitir que um engenheiro cético nos avalie. Se uma frase não resistir à pergunta "diz quem?", ela não é publicada.
Esta página é a própria regra, para que você possa exigir que a cumpramos.
O que toda página de capacidade contém#
Cada página em SEO, GEO, AEO, Conteúdo pronto para agentes, Chat de IA, Análises e Traduções contém quatro blocos, nesta ordem.
| Bloco | O que deve conter | Como verificar |
|---|---|---|
| O que você obtém | O resultado nos seus termos — o que aparece na página, no painel ou na API | Abra seu próprio site e verifique |
| Como é construído | O mecanismo no nível que somente alguém que leu a implementação poderia descrever: limites, ordem de preferência, alternativas de fallback, o que acontece em caso de falha | Compare com o HTML renderizado, a resposta da API ou os dados exportados |
| Evidências | Cada regra como regra → por que a máquina ou o leitor se comporta dessa maneira → um link para uma fonte primária | Abra o link |
| Limites | O que o recurso não faz, o que não é medido, o que depende de uma versão do modelo que não controlamos | Avalie se deixamos algo de fora |
Uma página sem um bloco de limites é um folheto, e os folhetos são menos — não mais — acreditados.
O que conta como uma fonte aqui#
Classificamos as fontes, e a classificação é visível na forma como uma afirmação é formulada.
- Especificações e documentação dos fornecedores — Google Search Central, schema.org, W3C, IETF, a especificação do Model Context Protocol, a especificação llms.txt e a documentação publicada dos fornecedores de modelos envolvidos. Uma afirmação baseada em uma dessas fontes é apresentada de forma categórica.
- Pesquisas revisadas por pares ou preprints com método e tamanho da amostra declarados. Apresentadas com o método incluído: “medido em 10.000 consultas” informa até que ponto confiar no resultado.
- Estudos independentes com metodologia publicada. Sempre atribuídos na frase — “X mediu”, nunca “sabe-se que”.
- Resultados divulgados pelos fornecedores, incluindo os nossos. Identificados como divulgados pelo fornecedor. Nossas próprias medições internas são identificadas como nossas.
Qualquer coisa abaixo dessa linha não é evidência e não aparece.
O que deliberadamente não afirmamos#
Estas são as afirmações que se espera que um fornecedor de documentação faça, e o motivo pelo qual não as fazemos.
- Nenhum aumento na taxa de citações. Ninguém pode prometer honestamente que ativar um recurso fará com que o Perplexity ou o ChatGPT cite você N% mais vezes. O que foi medido em trabalhos controlados é mais restrito do que a versão de marketing disso, e o GEO diz exatamente o que foi medido e por quem.
- Nenhuma porcentagem de precisão das respostas de IA. Um número produzido em nosso próprio corpus, com nosso próprio avaliador, não é evidência sobre o seu corpus. O chat de IA descreve o que o pipeline faz para se manter fundamentado e o que mede, sem inventar uma pontuação.
- Nenhuma garantia de classificação. A classificação nas pesquisas não é um contrato, e o Google afirma isso em sua própria documentação. O SEO separa o que é documentado pelo Google daquilo que é inferência.
- Nenhum status de conformidade que não tenhamos obtido. A segurança do MCP declara a posição atual e especifica o que ainda não é oferecido.
Blocos "sob questionamento"#
Quando uma afirmação nestes documentos não pode ser verificada — o mecanismo mudou, a fonte acabou não dizendo aquilo para o qual foi citada ou ninguém publicou uma medição — não excluímos a frase nem a suavizamos até torná-la vaga. Ela se torna um bloco explícito:
Sob questionamento. A afirmação. O que é verificável: a parte que é. O que não é: a parte que não é, e por quê. Trate-a como uma hipótese até que seja medida.
Esse bloco é uma promessa sobre nosso processo: uma afirmação que não podemos sustentar fica visível para você, em vez de ser removida silenciosamente.
Como essas afirmações permanecem verdadeiras#
A documentação se distancia silenciosamente de um produto, que é o modo de falha que o Docsbook existe para corrigir — por isso, o mesmo mecanismo é executado nestes documentos.
- Cada mudança voltada ao usuário é acompanhada de uma entrada no changelog, informando o que a mudança pretendia proporcionar, não apenas o que foi alterado.
- O changelog é projetado em páginas por resultado, para que você possa ler o histórico de um resultado — citações de IA, volume de suporte, tráfego orgânico — em vez de uma lista simples.
- As páginas exibem uma data visível da última modificação, obtida do commit que as alterou, para que uma página desatualizada não possa fingir que está atualizada. Veja GEO.
Encontrou algo errado?#
Uma afirmação nestas páginas que não corresponde ao que o produto faz é um defeito, e preferimos saber disso por você a deixá-la assim.
- Envie um e-mail para support@docsbook.io com a página e a frase.
- Ou diga isso no Discord do Docsbook.
Relacionado#
- Visão geral — o que o Docsbook faz, de ponta a ponta.
- Preços — o que é medido e pelo que o saldo de um projeto paga.
- FAQ — custos, cancelamento, sincronização, privacidade e propriedade dos dados.