Ottimizza la tua documentazione sia per i motori di ricerca tradizionali sia per i motori di risposta basati su AI come ChatGPT, Perplexity e Google AI Overviews. La Generative Engine Optimization (GEO) punta a ottenere citazioni dai sistemi di AI attraverso contenuti completi e informazioni strutturate, mentre la SEO tradizionale mira al posizionamento nei risultati di ricerca.

​
Guida rapida a GEO

​
Configurazione iniziale

  1. Assicurati che la documentazione venga indicizzata nelle impostazioni di docs.json
  2. Controlla le pagine esistenti per individuare titoli e descrizioni mancanti

​
Miglioramenti ai contenuti

  1. Aggiungi tabelle di confronto alle pagine pertinenti
  2. Rivedi le intestazioni per assicurarti che rispondano alle domande più frequenti
  3. Migliora i collegamenti interni tra argomenti correlati
  4. Metti alla prova con strumenti di AI per verificarne l’accuratezza

​
Best practice per la GEO

In generale, una documentazione ben scritta e ben strutturata avrà una GEO solida. Continua a dare priorità alla scrittura per i tuoi utenti e, se i contenuti soddisfano le loro esigenze, sarai già sulla buona strada per ottimizzare per gli strumenti di IA. Creare contenuti realmente utili, invece di ottimizzare per il solo gusto di farlo, viene premiato sia dai motori di ricerca tradizionali sia da quelli basati su IA. Concentrati su:
  • Contenuti allineati alle esigenze degli utenti anziché sul semplice abbinamento di keyword
  • Informazioni strutturate e facilmente consultabili
  • Risposte dirette alle domande

​
Formato per una migliore chiarezza

Queste pratiche di formattazione aiutano gli strumenti di IA ad analizzare e comprendere i tuoi contenuti:
  • Non saltare i livelli di intestazione (H1 → H2 → H3)
  • Usa nomi di oggetti specifici invece di “it” o “this”
  • Etichetta i blocchi di codice con il relativo linguaggio di programmazione
  • Fornisci alle immagini un testo alternativo descrittivo
  • Collega concetti correlati per aiutare l’IA a comprendere le relazioni

​
Rispondi direttamente alle domande

Scrivi contenuti che rispondano a domande specifiche degli utenti:
  • Inizia le sezioni con il messaggio principale
  • Usa titoli descrittivi che rispecchino le ricerche più comuni
  • Suddividi gli argomenti complessi in passaggi numerati

​
Configurazione di Mintlify

Usa queste funzionalità per migliorare la GEO.

​
Aggiungi metadati descrittivi alla pagina

Includi titoli e descrizioni chiari nel frontmatter: 
---
title: "Guida all'autenticazione API"
description: "Guida completa all'implementazione dell'autenticazione API con esempi di codice"
---

​
Configura le impostazioni globali di indicizzazione

Aggiungi al file docs.json: 
{
  "seo": {
    "indexing": "all",
    "metatags": {
      "og:type": "website",
      "og:site_name": "Your docs"
    }
  }
}

​
LLMs.txt

I file LLMs.txt aiutano i sistemi di intelligenza artificiale a comprendere la struttura della documentazione, in modo analogo a come le sitemap aiutano i motori di ricerca. Mintlify genera automaticamente i file LLMs.txt per la tua documentazione. Non è necessaria alcuna configurazione.

​
Test della documentazione

Prova diversi strumenti di intelligenza artificiale con domande sul tuo prodotto e sulla tua documentazione per vedere quanto bene i tuoi contenuti vengono citati. Poni agli Assistenti domande specifiche sulla tua documentazione:
  • “Come configuro l’autenticazione utilizzando questa API?”
  • “Accompagnami nel processo di installazione passo dopo passo”
Verifica che gli strumenti forniscano:
  • Esempi di codice corretti
  • Istruzioni accurate, passo dopo passo