Registro modifiche

Scegli l'URL della documentazione. L'hosting su sottopercorso non ti vincola più a /docs: scegli qualsiasi percorso di un solo segmento (/help, /guide o quello più adatto al tuo sito) dalla scheda Custom Domain nella dashboard. La ridenominazione è sicura: /docs continua a funzionare, i canonical vengono spostati immediatamente al nuovo sottopercorso e il sottopercorso personalizzato precedente reindirizza al nuovo per una ridenominazione, così nulla di già indicizzato o collegato si interrompe. Aggiorna il riferimento /docs del proxy quando vuoi. Hosting su sottopercorso →

Correggi con l'AI, più velocemente. Le scansioni terminano più rapidamente e in modo più affidabile, anche sui siti con molta documentazione; inoltre, riaprire l'anteprima della correzione è quasi istantaneo, perché Jamdesk memorizza nella cache i risultati della scansione e li riutilizza finché la documentazione non cambia. Passa da un avviso di build a una correzione salvata in pochi secondi. Correggi con l'AI →

Un quarto tema: Halo. Imposta "theme": "halo" nel tuo docs.json per un aspetto caldo e con angoli morbidi. È il quarto splendido tema integrato, con sfondo color sabbia, accento caramello, Figtree e angoli molto più arrotondati rispetto agli altri tre. Temi →

Pubblica la documentazione solo dal tuo dominio. Attiva Custom domain only nelle impostazioni del dominio personalizzato del progetto: YOUR_SLUG.jamdesk.app non risponderà più direttamente. La documentazione sarà raggiungibile dal tuo dominio e da nessun altro. Prima di attivare l'opzione viene eseguito un controllo preliminare sul dominio attivo, così un proxy configurato male non può bloccare accidentalmente i lettori; se il DNS dovesse interrompersi, il sottodominio ricomincia a pubblicare la documentazione invece di renderla offline. I domini con CNAME semplice non richiedono alcuna configurazione; lo stesso vale per i proxy che inviano già X-Jamdesk-Forwarded-Host; gli utenti Vercel con rewrites devono aggiungere ?jd_proxy=1 a ogni destinazione. In questo modo l'indirizzo Jamdesk viene nascosto ai motori di ricerca e ai visitatori occasionali, ma non si tratta di una password: se vuoi controllare chi può leggere la documentazione, abbina questa opzione alla protezione tramite password. Solo dominio personalizzato →

Modifica la documentazione direttamente dalla dashboard. L'editor web è ora disponibile per tutti e non richiede configurazione. Apri Editor nella barra laterale per esplorare il repository collegato, modificare MDX con un'anteprima live e salvare direttamente nel branch GitHub, avviando automaticamente una build. Editor web →

Correggi gli avvisi di build con l'AI, dalla dashboard. Quando una build termina con link non validi o pagine prive di descrizione, nella build viene visualizzato un banner Fix with AI che mostra quanti problemi possono essere corretti. Aprilo per visualizzare in anteprima ogni modifica proposta, inclusi gli anchor riscritti e le descrizioni di pagina suggerite, quindi applica quelle approvate. Jamdesk le salva nel branch GitHub e avvia una nuova build. Gli elementi che non possono essere risolti senza ambiguità vengono elencati separatamente per consentirti di correggerli manualmente. Correggi con l'AI →

Membri del team illimitati. Ogni progetto ora include membri del team illimitati in tutti i piani, senza costi aggiuntivi. Il precedente limite di 10 membri e il prezzo per postazione sono stati rimossi: invita tutto il team.

Consenti ai bot autorizzati di pubblicare la documentazione. Gli account di automazione come Dependabot, Renovate o un bot di pubblicazione del CMS non sono membri di Jamdesk, quindi per impostazione predefinita i loro push non attivano una build. Ora, quando uno di questi viene rifiutato, la build mostra un pulsante Authorize Bot Account con un solo clic. Approvandolo, i push di quell'account pubblicano sul sito attivo, proprio come quelli di un membro del team. Solo i membri del progetto possono autorizzare un account; puoi esaminare o revocare l'accesso in qualsiasi momento nella sezione Allowed automation accounts delle impostazioni GitHub del progetto.

La documentazione riceve un AI Score a ogni build. Jamdesk ora valuta automaticamente, dopo ogni build e direttamente nella dashboard, quanto bene gli agenti AI riescano a leggere la documentazione pubblicata, sulla base dello standard AFDocs. Visualizza il punteggio da 0 a 100 e il relativo voto, osserva l'andamento tra le build e ricevi una correzione in linguaggio semplice per ogni problema, con un pulsante Copy prompt to fix che invia il risultato al tuo agente AI per la scrittura del codice. Attiva Email team when score changes per ricevere una notifica quando una build modifica significativamente il punteggio. AI Score →

Correggi automaticamente i link non validi. Gli avvisi relativi a link interni non validi con una destinazione non ambigua, come anchor con errori di battitura o disallineamenti degli anchor tra le lingue, possono ora essere corretti con un solo comando. Esegui jamdesk fix --dry-run per visualizzare in anteprima le modifiche previste, quindi jamdesk fix per applicarle; vengono modificati solo gli avvisi in cui l'anchor corretto rimanda a un'intestazione reale, mentre i casi ambigui restano da esaminare manualmente. Panoramica CLI →

Annuncia qualsiasi cosa con un banner. Aggiungi un banner al tuo docs.json per fissare una barra di messaggio nella parte superiore di ogni pagina, sopra l'intestazione e nel colore d'accento del tema. Usa link, grassetto e corsivo inline e imposta dismissible: true per offrire ai lettori un pulsante di chiusura; il banner resterà chiuso finché non modifichi il messaggio. Banner →

Mostra quando ogni pagina è stata aggiornata. Imposta metadata.timestamp: true nel tuo docs.json per aggiungere al piè di pagina di ogni pagina una riga come "Last updated on June 15, 2026". La data proviene dall'ultimo commit Git che ha modificato la pagina, quindi rimane aggiornata a ogni build senza manutenzione manuale. Metadati delle pagine →

Personalizza le icone di navigazione. Le icone della barra laterale, dei gruppi, delle schede, degli anchor e della ricerca ora rispettano lo style di un oggetto icona ({ "name": "rocket", "style": "duotone" }) o un prefisso di stile (duotone/rocket): light, thin, duotone e sharp, non solo solid. Icone →

Personalizza la barra di ricerca. Scegli il testo segnaposto con search.prompt e seleziona i link rapidi mostrati ai visitatori nel pannello di ricerca vuoto con search.popularPages, ciascuno con un titolo, uno slug di pagina e un'icona Font Awesome. Configurazione della ricerca →

Raccogli iscrizioni email senza embed. Collega Resend, Mailchimp, Kit, Loops, beehiiv, Brevo o SendGrid in Integrations → Email Signups: un modulo ospitato da Jamdesk aggiunge direttamente i lettori al tuo pubblico, mentre la chiave API resta nel nostro backend e non viene mai pubblicata sul tuo sito. Aggiungi il componente EmailSubscribe a qualsiasi pagina oppure imposta placement: changelog per inserire automaticamente un modulo di iscrizione in ogni pagina del changelog. Iscrizioni email →

Subordina le analisi al consenso dei cookie. Aggiungi la chiave integrations.cookies al tuo docs.json: Jamdesk non carica alcuno script di analisi o tracciamento, inclusi Google Analytics, GTM, Plausible, Crisp, JavaScript personalizzato e le analisi integrate, finché il visitatore non esprime il consenso, letto da un flag localStorage impostato dal banner. Puoi caricare un banner Osano o Termly direttamente dal docs.json; un breve snippet di collegamento attiva il flag quando il lettore accetta e gli script vengono caricati senza ricaricare la pagina. Consenso cookie →

llms.txt, in ordine. Il file llms.txt di ogni sito ora segue la struttura di llmstxt.org: le schede e i gruppi di navigazione diventano sezioni ##, così gli agenti AI vedono la documentazione organizzata come nella barra laterale. I siti multilingue ricevono un indice per ogni lingua: il file principale elenca la lingua predefinita e collega ogni indice tradotto, ad esempio /fr/llms.txt, mantenendo ciascuno abbastanza piccolo da evitare il troncamento da parte degli agenti. llms.txt →

Gli agenti trovano più rapidamente la documentazione. Ogni pagina ora contiene una direttiva invisibile e silenziosa per gli screen reader che indirizza gli agenti AI a llms.txt e alla versione .md della pagina; inoltre, ogni esportazione Markdown inizia con un blockquote che collega all'indice. Gli agenti che recuperano il tuo HTML non devono più supporre che esista un percorso Markdown. Panoramica AI →

Incorpora il changelog ovunque. Un launcher "What's new?" entra nella tua app con un solo tag <script> e apre il changelog Jamdesk in una finestra modale, con un indicatore dei contenuti non letti per visitatore. Genera lo snippet da Integrations → What's New widget, quindi regola modalità del launcher, angolo, dimensioni della finestra e colore dell'indicatore con gli attributi data-. Nella documentazione Jamdesk, il componente MDX <Widget> inserisce lo stesso launcher live in qualsiasi pagina con un solo tag e senza script. Incorpora il changelog →

Scarica le specifiche API in un archivio zip. In qualsiasi pagina di riferimento API, il menu AI Actions include ora l'opzione Download API spec, che raccoglie tutte le specifiche OpenAPI a cui fa riferimento il sito, sia file locali sia URL remoti, in un unico api-specs.zip. Le specifiche multi-file mantengono la struttura delle cartelle $ref, quindi il download può essere usato direttamente in Postman, in un generatore di client o nei tuoi strumenti. AI Actions →

Specifiche OpenAPI validate durante la build. Ogni deploy ora valida rigorosamente le specifiche OpenAPI a cui fa riferimento il tuo docs.json e mostra ogni problema come non-fatal build warning, invece di interrompere la build. La documentazione viene comunque pubblicata; ricevi semplicemente l'indicazione precisa dell'errore, ad esempio un errore di parsing YAML con riga e colonna, un $ref non risolto o un operationId duplicato, via email e nell'elenco delle build della dashboard. In locale, jamdesk dev si interrompe ancora quando trova una specifica non valida, così puoi correggerla prima del push. Panoramica CLI →

Chiedi all'AI direttamente dalla ricerca. Inizia a digitare nella ricerca, quindi invia la domanda alla chat AI invece di aprire un risultato: premi ⌘/Ctrl+Enter oppure fai clic su Ask AI nel piè di pagina della ricerca. La domanda viene aggiunta alla conversazione della chat, così puoi continuare il thread; il normale tasto Invio apre ancora il primo risultato. Chat AI →

Copia risposte e trascrizioni. Ogni risposta della chat AI dispone di un pulsante per copiare il sorgente Markdown; l'azione Copy transcript nell'intestazione della chat copia l'intera conversazione in Markdown con i ruoli indicati, utile per incollarla in un issue o in un documento. Chat AI →

Scorrimento automatico della chat più intelligente. La chat segue una risposta in streaming solo quando ti trovi già in fondo. Se scorri verso l'alto per rileggere una risposta precedente, la posizione resta invariata invece di riportarti in fondo; tornando in fondo, lo scorrimento viene riattivato.

CSS personalizzato nell'anteprima locale (CLI). jamdesk dev applica il CSS personalizzato come la build pubblicata, così puoi verificare lo stile prima del deploy. Inserisci un file .css nella radice del progetto, ad esempio style.css, oppure più file combinati in ordine alfabetico: verrà caricato al refresh del browser. Non serve alcuna voce in docs.json, in linea con il modo in cui Mintlify include i fogli di stile nella radice. CSS personalizzato →

Anteprime social personalizzate dal frontmatter. Imposta qualsiasi metatag Open Graph o Twitter/X direttamente nel frontmatter di una pagina: og:title, og:description, og:image, twitter:card, keywords e l'intero set di metatag. Usa chiavi di primo livello oppure un blocco seo: annidato: entrambi funzionano e i valori della singola pagina sostituiscono le impostazioni predefinite del docs.json. SEO →

Pagine nascoste. Escludi bozze, manuali interni o guide obsolete dalla barra laterale e dai risultati di ricerca senza eliminarli. Aggiungi hidden: true al frontmatter di una pagina oppure a un gruppo o una scheda in docs.json. Le pagine nascoste restano raggiungibili tramite URL diretto, ma scompaiono dalla navigazione, dalla sitemap, dalla ricerca del sito e dal contesto AI, oltre a ricevere automaticamente un tag noindex. Ti serve un gruppo nascosto le cui pagine continuino a comparire nei risultati? Aggiungi searchable: true insieme a hidden. Pagine nascoste →

Decorazioni a griglia e finestre. Due nuovi motivi di sfondo si aggiungono al gradiente predefinito del tema Jam. Imposta background.decoration su "grid" per una discreta griglia di punti da 24 px oppure su "windows" per due macchie effetto vetro nello stile di Windows 11 negli angoli superiori. Il gradiente e il riempimento uniforme "none" continuano a funzionare come prima: scegli l'aspetto più adatto al tuo brand. Sfondo →

Personalizzazione dello sfondo. Un nuovo blocco background in docs.json disattiva il gradiente della modalità chiara di Jam, sostituisce il colore della pagina per modalità oppure regola colore, dimensioni, posizione e opacità del gradiente. Non serve CSS personalizzato. Sfondo →

Diagrammi D2. Un secondo linguaggio per diagrammi si aggiunge a Mermaid. Contrassegna un blocco di codice delimitato con d2 e Jamdesk lo renderizza come SVG durante la build, con temi chiaro e scuro integrati. Il flusso di lavoro è lo stesso di Mermaid: scegli il linguaggio più adatto al diagramma da creare. Diagrammi D2 →

Risultati di ricerca raggruppati. La ricerca non ripete più la stessa pagina per ogni corrispondenza nelle sezioni. I risultati vengono raggruppati sotto la pagina principale nella finestra di ricerca, con fino a tre sezioni visibili per impostazione predefinita e un espansore inline per le altre. L'evidenziazione degli snippet resta invariata: trovi la sezione corretta con meno scansioni.

Rilevamento automatico di docs.json durante la connessione. Quando colleghi un repository GitHub, viene trovato il tuo docs.json ovunque si trovi. Il flusso di connessione analizza l'intero albero e segnala un mint.json di Mintlify se ne trova uno. Monorepo e configurazioni annidate funzionano senza configurazione manuale. Connessione a GitHub →

Indicazioni sulla posizione di docs.json nella CLI. Le configurazioni nella posizione sbagliata sono più facili da individuare. jamdesk validate, jamdesk dev e jamdesk doctor indicano dove si trova effettivamente il tuo docs.json, o dove dovrebbe trovarsi, invece di mostrare un generico errore "not found". Risolvi il problema in pochi secondi invece di interpretare uno stack trace. Panoramica CLI →

Hreflang conforme agli standard. I tag hreflang ora generano codici BCP 47 validi. Le cartelle locali come cn, jp e ja-jp vengono mappate sui codici attesi dai motori di ricerca (zh, ja) e gli URL della sitemap vengono sottoposti a escape XML. Ogni pagina localizzata si posiziona nella propria regione invece di essere trattata come contenuto duplicato. Lingue →

Esportazione PDF. Esegui il rendering dell'intero sito della documentazione in un singolo PDF da Settings → PDF Exports nella dashboard. Solo per i piani a pagamento. Nei progetti multilingue puoi selezionare una lingua per ogni esportazione; i risultati vengono memorizzati nella cache per commit e ricevi un'email con il link per il download al termine del rendering.

Specifiche OpenAPI multilingue. Le pagine degli endpoint mostrano le specifiche OpenAPI tradotte insieme all'MDX tradotto. Inserisci un file <spec>.<lang>.<ext> (ad esempio openapi/api.fr.yaml) accanto alla specifica di origine: Jamdesk lo utilizzerà negli URL di quella lingua, ricorrendo alla specifica inglese quando manca una variante linguistica. Vengono localizzati riepiloghi delle operazioni, descrizioni dei parametri, descrizioni delle risposte e descrizioni degli schemi. Configurazione: Traduzione delle specifiche OpenAPI.

Componente Visibility. Il nuovo componente <Visibility for="humans|agents"> consente di separare nello stesso documento i contenuti destinati ai lettori umani o agli agenti AI. I blocchi riservati agli umani vengono visualizzati nel browser ma rimossi dalle esportazioni .md e da llms-full.txt; per i blocchi riservati agli agenti avviene il contrario. Gli agenti che richiedono Accept: text/markdown sugli URL canonical ricevono automaticamente la vista per agenti.

Protezione tramite password, ricostruita. Blocca l'intero sito con una password condivisa oppure proteggi solo alcune pagine lasciando pubbliche le altre. Imposta auth.password.enabled: true per la modalità dell'intero sito oppure contrassegna singole pagine con private: true nel frontmatter, o elencale sotto auth.password.private, per la modalità dedicata a pagine specifiche. La pagina Settings della dashboard mostra la procedura per impostare, ruotare e revocare la password. I visitatori vedono una schermata di sblocco con il logo del sito, il colore primario e un suggerimento opzionale definito in docs.json. Guida alla configurazione: Protezione tramite password.

Conversione automatica delle immagini in WebP. Jamdesk può convertire le immagini PNG e JPG in WebP durante la build. I file convertiti sono generalmente più piccoli del 60-80% rispetto agli originali, senza perdita visibile di qualità, così le pagine si caricano più velocemente senza elaborazione manuale delle immagini. Attiva l'opzione con images.convertToWebp: true in docs.json. Favicon, og:image e twitter:image restano nel formato originale per garantire la compatibilità con i crawler dei social. Un nuovo passaggio Optimizing images mostra l'avanzamento live nella dashboard e nella CLI durante ogni build. Conversione automatica delle immagini →

API Playground. Le pagine degli endpoint ora dispongono di un "Try it button" interattivo. Compila i parametri, osserva l'aggiornamento in tempo reale degli esempi di codice e invia richieste live senza uscire dalla documentazione. Attivo per impostazione predefinita in tutte le pagine API. Funziona sia con endpoint OpenAPI sia con endpoint scritti in MDX.

Plugin Claude Code. Installa il plugin Jamdesk per Claude Code per fornire a Claude una conoscenza approfondita dei componenti MDX, della configurazione docs.json, dei modelli di navigazione e dei comandi CLI. Installazione in due passaggi dal marketplace dei plugin. Si abbina a CLAUDE.md e al server MCP per la scrittura assistita della documentazione.

Avvisi di build per branding mancante. Le build ora avvisano quando i percorsi favicon o logo in docs.json fanno riferimento a file inesistenti nel progetto. Gli avvisi compaiono nei dettagli della build nella dashboard e nella CLI tramite jamdesk dev e jamdesk validate. Non viene inviata alcuna email: l'avviso ha solo valore informativo.

YouTube Shorts. Il componente <YouTube> supporta gli Shorts verticali tramite la prop short e mostra un player 9:16 centrato senza barre nere. Usa <YouTube id="VIDEO_ID" short />.

Menu AI Actions. Un menu a discesa su ogni pagina consente ai lettori di copiare Markdown, aprire la pagina in ChatGPT/Claude/Perplexity, ottenere la configurazione del server MCP o installarlo con un clic in Cursor o VS Code. È attivo per impostazione predefinita; scegli quali opzioni mostrare tramite contextual in docs.json.

Analisi. Analisi delle pagine senza cookie per monitorare visualizzazioni, sorgenti del traffico e tendenze dei visitatori, con dettagli per pagina. Non serve alcun banner di consenso. Panoramica: Analisi.

Integrazioni. Google Analytics 4, Google Tag Manager, Plausible Analytics e notifiche di build Slack (Pro).

Feed RSS per i changelog. Le pagine con rss: true nel frontmatter ora generano automaticamente un feed RSS sottoscrivibile. Accanto al titolo della pagina compare un'icona RSS e durante ogni build viene creato un feed.xml dai componenti Update. Usa la nuova prop date su Update per ottenere date corrette nel feed.

Accesso e deploy dalla CLI. jamdesk login esegue l'autenticazione tramite browser. jamdesk deploy impacchetta il progetto e avvia una build dal terminale. Non è necessaria una connessione GitHub. La CLI rispetta .gitignore, avvisa della presenza di file segreti e trasmette l'avanzamento della build inline.

Controllo ortografico CLI. jamdesk spellcheck verifica gli errori ortografici nella documentazione con oltre 180 termini tecnici integrati (solo in inglese). jamdesk spellcheck --fix avvia una modalità interattiva per correggere gli errori o aggiungere parole all'elenco di esclusione.

Embed video. Incorpora direttamente nella documentazione file .mp4 e .webm. Inseriscili in una directory /videos e usa la sintassi Markdown (<Video src="/_jd/videos/demo.mp4?v=msuxsk5d" title="Demo" />) oppure il componente <Video> per autoplay, loop e altri controlli.

JavaScript personalizzato. Aggiungi script lato client per widget di chat, analisi o integrazioni di terze parti tramite styling.js in docs.json.

Chat AI. Assistente chat integrato in ogni sito di documentazione. I visitatori pongono domande e ricevono risposte con link di citazione alle pagine di origine. Basato su Claude e attivo in tutti i piani.

Integrazione AI. Ogni sito genera llms.txt per le finestre di contesto LLM, espone Markdown grezzo negli URL .md e include un server MCP in /_mcp con gli strumenti searchDocs e getPage. Guide alla configurazione per Claude Code, Cursor e Codex. Inoltre: Scrivere con l'AI e Aggiornamenti automatizzati.

CLI. jamdesk dev per l'anteprima locale con hot reload, jamdesk validate per i link non validi, jamdesk migrate per convertire da Mintlify/GitBook/Docusaurus e jamdesk doctor per i problemi di configurazione. Installa tramite npm, curl o Homebrew. Riferimento completo →

Estensione VS Code. Avvia, arresta e riavvia il server di sviluppo dalla barra di stato di VS Code, senza usare il terminale.

Verifica TXT del dominio personalizzato. Tutti i domini personalizzati ora richiedono un record TXT (_jamdesk.yourdomain.com) prima dell'attivazione del routing. Questo impedisce la presa di controllo di sottodomini non reclamati. I domini aggiunti di recente mostrano il record TXT nella procedura di configurazione della dashboard. Consulta la guida ai domini personalizzati.

Supporto multilingue. Definisci alberi di navigazione e directory di contenuti separati per ogni lingua. I lettori cambiano lingua da un menu a discesa nella barra superiore.

Analisi della ricerca. Cosa cercano i lettori, quali query non restituiscono risultati e quali risultati vengono effettivamente aperti. Utile per individuare le lacune nei contenuti.

Jamdesk è disponibile. Scrivi la documentazione in MDX, esegui il push su GitHub e ottieni un sito su una CDN globale. Le build terminano in meno di 60 secondi.

MDX e componenti. Oltre 20 componenti integrati: schede, fisarmoniche, passaggi, gruppi di codice, diagrammi Mermaid, formule KaTeX e icone. Evidenziazione della sintassi con numeri di riga nei blocchi di codice. Crea componenti React personalizzati con Tailwind e hook e riutilizza i contenuti con gli snippet. Panoramica dei componenti →

Documentazione OpenAPI. Genera pagine di riferimento API dalla tua specifica OpenAPI tramite api.openapi in docs.json.

Deploy. Esegui il deploy automatico da GitHub al push con un debounce di 10 secondi. Domini personalizzati con SSL automatico, hosting su sottopercorso in /docs (Vercel, CloudFront, Cloudflare, nginx) e supporto per monorepo.

Personalizzazione. Tre temi (jam, nebula, pulsar) con colori, loghi e piè di pagina personalizzati. CSS personalizzato per sostituire gli stili. Navigazione flessibile con schede, gruppi e icone. Reindirizzamenti con corrispondenza esatta e tramite wildcard.

Ricerca e SEO. Ricerca full-text Cmd+K senza configurazione. Sitemap, immagini OG e metadati per pagina pronti all'uso.

Riferimento di docs.json. Riferimento completo per tutte le impostazioni e opzioni.

Centro assistenza. Guide per gestione dell'account, fatturazione e risoluzione dei problemi.