Pular para o conteúdo principal

Verificação de Fatos & Atualização

Intermediário

"Sempre atualizado" é uma promessa que mantemos com um sistema simples e honesto — não com mágica. Veja como cumpri-la quando você contribui.

Perene vs. volátil​

  • Perene — conceitos que não mudam (o que é um LLM, o que é RAG). Nenhuma data necessária.
  • Volátil — qualquer coisa que mude de release para release: nomes/IDs de modelos, preços, limites, rótulos de UI, disponibilidade de beta/funcionalidade, flags exatas de CLI. Deve carregar uma data + fonte.

Carimbe os fatos voláteis​

Use o componente <VerifyNote> logo abaixo do selo de nível:

<VerifyNote lastVerified="2026-08-10" source="https://platform.claude.com/docs/...">
One line on what's volatile here and to confirm at the source.
</VerifyNote>
  • lastVerified = a data em que você realmente verificou contra a fonte.
  • source = a página oficial que é a autoridade.

Nunca fixe fatos de modelo no código​

IDs/preços/contexto de modelos ficam apenas em data/models.json, renderizados por <ModelTable /> na página de modelos. Na prosa, faça link para lá em vez de escrever um ID de modelo ou preço. Atualizar modelos = uma edição de uma linha nesse JSON (um primeiro PR perfeito).

Respondendo a needs-verification​

A automação (e os leitores) abrem issues rotuladas com needs-verification quando um fato pode estar desatualizado. Para resolver uma:

  1. Verifique a afirmação contra a fonte oficial.
  2. Se estiver correta → atualize lastVerified para hoje.
  3. Se mudou → corrija o conteúdo e a data, e faça link para a fonte.
  4. Se for um fato de modelo → atualize data/models.json, não a prosa.

O princípio da honestidade​

Uma data antiga é uma funcionalidade

Um lastVerified de meses atrás não significa que falhamos — ele diz ao leitor para checar novamente aquele fato. Melhor uma data antiga honesta do que uma errada com confiança. Não atualize uma data que você não verificou de fato.

Próximo​