Passa al contenuto principale

Verifica dei fatti e freschezza

Intermedio

"Sempre aggiornato" è una promessa che manteniamo con un sistema semplice e onesto — non con la magia. Ecco come rispettarla quando contribuisci.

Sempreverdi vs volatili​

  • Sempreverdi — concetti che non cambiano (cos'è un LLM, cos'è il RAG). Non serve alcuna data.
  • Volatili — tutto ciò che cambia da una release all'altra: nomi/ID dei modelli, prezzi, limiti, etichette dell'interfaccia, disponibilità di beta/funzionalità, flag esatti della CLI. Devono riportare una data + fonte.

Marca i fatti volatili​

Usa il componente <VerifyNote> subito sotto il badge di livello:

<VerifyNote lastVerified="2026-06-20" source="https://docs.anthropic.com/...">
One line on what's volatile here and to confirm at the source.
</VerifyNote>
  • lastVerified = la data in cui tu hai effettivamente verificato il fatto rispetto alla fonte.
  • source = la pagina ufficiale che fa autorità.

Non scrivere mai a codice fisso i fatti sui modelli​

Gli ID dei modelli/prezzi/contesto risiedono solo in data/models.json, renderizzato da <ModelTable /> nella pagina dei modelli. Nella prosa, collega quella pagina invece di scrivere un ID di un modello o un prezzo. Aggiornare i modelli = una modifica di una riga a quel JSON (una prima PR perfetta).

Rispondere a needs-verification​

L'automazione (e i lettori) aprono issue con l'etichetta needs-verification quando un fatto potrebbe essere obsoleto. Per risolverne uno:

  1. Verifica l'affermazione rispetto alla fonte ufficiale.
  2. Se è corretta → porta lastVerified a oggi.
  3. Se è cambiata → correggi il contenuto e la data, e collega la fonte.
  4. Se è un fatto su un modello → aggiorna data/models.json, non la prosa.

Il principio di onestà​

:::tip Una data vecchia è una funzionalità Un lastVerified di mesi fa non significa che abbiamo fallito — dice al lettore di ricontrollare quel fatto. Meglio una data vecchia ma onesta che una sbagliata ma sicura di sé. Non aggiornare una data che non hai davvero ri-verificato. :::

Avanti​