Aggiornamenti del prodotto

Nuove release e miglioramenti

​

31 agosto - 13 settembre

New releasesImprovements

Release principali

• Miglioramento importante: pagine suggerite dall’AI sulle pagine 404, quando qualcuno apre un collegamento non valido → l’agente AI legge il percorso → suggerisce pagine semanticamente simili
• Major release: la ricerca web per l’assistente può ora includere fonti esterne
  Nota: contattaci per abilitare questa funzionalità per il tuo sito.

Assistente e MCP

• Corretto un bug per cui l’assistente veniva soggetto a rate limit in modo errato perché la time window non scorreva correttamente
• Corretto un bug nelle chiamate agli strumenti dell’assistente per gestire correttamente i blocchi text vuoti
• Corretto un bug per cui i nomi del server MCP concatenati con le chiamate agli strumenti talvolta superavano il limite di 60 caratteri imposto dai client MCP
• Corretto un bug per cui il menu dell’assistente aveva un’altezza più volte superiore alla viewport e scorreva all’infinito
• Corretto un bug per cui i valori di spesa dell’assistente potevano essere mostrati con più di due cifre decimali nella dashboard

Editor web e deployment

• Miglioramento di sicurezza nell’editor: solo gli utenti con write permissions per il repository Git collegato possono apportare modifiche
• Corretto un bug per cui i deployment di anteprima non funzionavano per i branch con = nel nome
• Corretto un bug per cui i nomi di branch lunghi fuoriuscivano dai modali durante la creazione dei deployment di anteprima
• Miglioramento dell’esperienza: il parametro di query email precompila il campo negli inviti di registrazione
• Corretto un bug per cui copiare una pagina dal menu contestuale non funzionava su Safari

Playground API e navigazione

• Più codici di risposta del Playground API ora vengono mostrati in un menu a selezione con stile controllato invece del menu di selezione predefinito di sistema quando è attivo
• Ora puoi usare il campo expanded sui gruppi di navigazione nel tuo docs.json per renderli aperti di default

SEO e UI

• Corretto un bug per cui le favicon non venivano visualizzate nei motori di ricerca servendole dallo stesso URL del sito di documentazione per ciascun sito
• Corretto un bug per cui gli embed di YouTube lampeggiavano durante il caricamento
• Corretto un bug per cui l’espansione del menu di feedback per includere risposte scritte causava uno spostamento del layout con l’indice dei contenuti
• Corretto un bug per cui il testo fuoriusciva sopra la topbar nel tema Maple quando si chiudeva il banner di notifica
• Migliorati i temi Maple e Willow aggiungendo pulsanti di login/logout alla sidebar per un accesso più semplice

Analytics ed esportazioni

• Risolti problemi di affidabilità con la vista analytics dell’assistente e le esportazioni
• Le esportazioni di analytics dell’assistente ora vengono eseguite in background e inviate via email per un’esperienza più affidabile

​

August 24 - August 30

Improvements

Release principale: raccolta di feedback migliorata

• Miglioramento principale: I lettori ora possono fornire feedback più dettagliati dopo aver selezionato pollice su/giù, incluse opzioni e commenti testuali. Puoi anche raccogliere feedback sui blocchi di codice e visualizzare tutte le risposte nelle analytics della tua dashboard.
  Nota: contattaci per abilitare questa funzionalità per il tuo sito.

Miglioramenti alla navigazione e alla qualità d’uso

• Miglioramento alla qualità d’uso per ignorare slash finali e doppi slash, così non devi preoccuparti di inserirli esattamente nel tuo docs.json
• Ora puoi aggiungere un attributo noAnchor ai tag HTML h1-6 per evitare che abbiano un link di ancoraggio
• Il tema Palm ora ha un selettore della lingua fluttuante in basso a sinistra simile all’approccio di Stripe
• Aggiunto un nuovo campo al docs.json chiamato drilldown che ti consente di controllare se, all’espansione di un gruppo di navigazione, gli utenti vengono indirizzati automaticamente alla prima pagina del gruppo
• Miglioramento alla qualità d’uso per far alternare gli stili delle liste ordinate annidate da decimale/romano ad alfabetico

Correzioni di bug e affidabilità

• Risolto un bug per cui i link di ancoraggio della posizione di scorrimento non funzionavano correttamente quando erano presenti componenti JS in una pagina
• Risolto un bug per cui Google indicizzava i file *.md grezzi perché mancava l’intestazione x-robots-tag: noindex
• Risolto un bug con OAuth sulla documentazione protetta per cui non venivi reindirizzato alla pagina di partenza una volta completato correttamente il flusso
• Risolto un bug nelle anteprime della documentazione protetta da autenticazione per cui non era possibile vedere l’intera barra di navigazione
• Correzioni su come gli SVG vengono gestiti con la nostra nuova CDN di immagini

Miglioramenti a componenti e styling

• Aggiunto un nuovo selettore CSS per stili personalizzati su SidebarNavGroupDivider
• Nuovi test di regressione per le pagine API definite in MDX con regole di sicurezza definite garantiranno un maggiore grado di stabilità

Miglioramenti delle prestazioni

• Miglioramento delle prestazioni spostando il CSS di KaTeX da cdnjs alla nostra CDN su CloudFront per ridurre la latenza

​

August 17 - August 23

Improvements

Miglioramenti alla gestione delle immagini

• Miglioramento principale: Le immagini non causano più spostamenti di layout per impostazione predefinita, anche quando gli attributi width e height non sono specificati—il dimensionamento automatico evita salti di contenuto durante il caricamento delle pagine
• Tutti i file statici nel tuo repository (PDF, TXT, XML, ecc.) ora vengono caricati e serviti automaticamente quando effettui il deployment, garantendo una copertura completa degli asset

Miglioramenti all’Editor web e al deployment

• Corretto il flusso di creazione dei branch nell’Editor web per navigare correttamente verso e restare sui branch appena creati
• Migliorata la finestra di dialogo dei conflitti di merge con una corretta funzionalità di escape; non sono più necessari ricaricamenti della pagina per chiudere i conflitti
• Ottimizzato il flusso di aggiornamento invalidando la cache solo delle pagine modificate durante gli aggiornamenti parziali, riducendo i tempi di deployment

Miglioramenti ad autenticazione e navigazione

• Nuovo supporto per l’autenticazione su sottodirectory personalizzate: se servi la documentazione su https://yourdomain.com/docs, l’autenticazione ora funziona senza problemi
• Risolto un bug di visualizzazione della sidebar che si presentava in modo errato quando era configurato un solo link
• Revisione completa della navigazione mobile: pulsanti centrati con margini/padding adeguati, spaziatura migliorata nei menu a discesa, rimossi divisori e margini non necessari per sezioni vuote e risolti i problemi di gap/padding nel tema Maple

Correzioni a componenti e styling

• Risolto il problema di conversione dei tag <h1-6> che li trasformava erroneamente in componenti Heading interrompendo lo stile personalizzato
• Aggiunto alla dashboard un interruttore “one-click” per configurare l’Assistente e semplificarne la gestione

Miglioramenti tecnici e affidabilità

• Sistema di logging migliorato per i flussi di aggiornamento che consente un debug più rapido e una risoluzione dei problemi più efficiente
• Risolto il rate limiting di GitHub per i clienti con oltre 10 specifiche OpenAPI/AsyncAPI passando dal recupero dei singoli file al cloning del repository
• Migliorata l’affidabilità dell’Assistente con supporto LLM di backup, gestione migliorata degli errori di rate limit e funzionalità di ricerca più robuste

​

10 agosto - 16 agosto

Improvements

Ottimizzazioni di prestazioni e build

• La transpilation MDX ora avviene al momento del deployment invece che a ogni caricamento di pagina negli ambienti serverless NextJS non in cache, migliorando il time to first byte per le pagine non in cache.
• L’hashing basato sul contenuto impedisce la ri-transpilazione quando l’MDX non è cambiato, riducendo i tempi del flusso di aggiornamento di circa il 50% per i clienti con molti contenuti (i deployment oltre i 5 minuti dovrebbero dimezzarsi circa)
• La visualizzazione dei Deployment di anteprima nella dashboard è ora più veloce grazie all’aggiunta di indici nel database e alla parallelizzazione delle query nel nostro backend
• Dimensioni della pagina ridotte eliminando i dati navigation duplicati nel payload rsc di ciascuna pagina—i miglioramenti delle prestazioni sono più evidenti con un elevato numero di pagine o strutture di navigazione complesse
• Un prefetching più aggressivo consente più spesso caricamenti istantanei delle pagine

Playground API e miglioramenti OpenAPI

• La conversione da OpenAPI a MCP è stata spostata nel backend, consentendo ai server MCP ospitati di includere tool (a breve documentazione e opzioni di configurazione più chiare)
• Aggiunto il supporto per Ruby nel Playground API
• Abbiamo aggiunto una funzionalità grazie alla quale ora puoi specificare le pagine API utilizzando solo il tuo docs.json senza creare nuovi file MDX.
• Supporto per pagine webhook nella navigazione della documentazione a partire da specifiche OpenAPI
• Ottimizzato il contesto del modello AI rimuovendo le specifiche degli anchor link dai link markdown quando si invia ad Anthropic, OpenAI o altri provider

Miglioramenti all’Editor web

• La creazione/ridenominazione dei file ora salva le modifiche al clic al di fuori del campo invece di richiedere la pressione del tasto Invio
• Corretto un problema di navigazione dei branch in cui modificare l’URL a un branch specifico reindirizzava all’ultimo branch attivo invece della destinazione prevista
• Codifica corretta in URL dei titoli dei branch contenenti / per evitare problemi di navigazione
• Corretto lo shortcut Ctrl+K per i link nell’Editor della dashboard monorepo che premetteva il path del repo dei docs creando link interrotti

Analytics e integrazioni LLM

• Supporto per llms.txt e llms-full.txt personalizzati—aggiungili alla radice del repo dei docs per servirli agli endpoint /llms.txt e /llms-full.txt per la Personalizzazione LLM
• Aggiunta l’integrazione analytics Hightouch
• Migliorato il tracciamento analytics del Menu contestuale (visualizzazione in dashboard in arrivo)
• Aggiunti test end-to-end per llms.txt e llms-full.txt per garantire una corretta erogazione

Miglioramenti a Componenti e styling

• Supporto per class name personalizzati nei tag h{1-4} per applicare stili di intestazione personalizzati
• Corretto il rendering dei tag h{1-4} come componenti Heading con chip in modalità pagina personalizzata
• Aggiunti selettori CSS ai breadcrumbs per targeting CSS personalizzato
• Corrette le immagini open-graph allungate analizzando le dimensioni per mantenere le proporzioni a 56 px di altezza
• Corretto VSCode in VS Code nel Menu contestuale quando abilitato
• Corrette le intestazioni all’interno di componenti personalizzati che apparivano nell’indice insieme alle intestazioni semantiche

Correzioni di bug e affidabilità

• Risolti problemi di render PDF con determinati titoli di pagina sanificando i caratteri che causavano problemi di generazione
• Risolto l’errore CLI Cannot convert undefined or null to object quando si incontravano file JSON OpenAPI vuoti
• Corrette le metatag open-graph personalizzate in docs.json che venivano sovrascritte da quelle generate
• Corretti i clic sul pulsante del feed RSS quando si atterrava su link di ancoraggio utilizzando origin + pathname per i link RSS
• Migliorata la velocità di download della CLI rimuovendo le sourcemap

Miglioramenti tecnici

• Aggiunti test visivi alla pipeline CI per un rilevamento anticipato delle regressioni
• Migliorata la gestione degli errori e le capacità di debug
• Copertura di test più completa per nuove funzionalità e casi limite

​

3 agosto - 9 agosto

Improvements

Miglioramenti all’autenticazione

• Accesso pubblico a livello di gruppo: rendi pubblici interi gruppi di pagine tramite docs.json, così non devi impostare public: true su ogni pagina (scopri di più)
• Supporto per logoutURL nella configurazione OAuth per eliminare i cookie upstream e completare il sign-out
• In caso di errori OAuth, gli utenti vengono reindirizzati al logoutURL specificato per riavviare il flusso di autenticazione
• Corretto un lampeggio di errore 500 durante i flussi OAuth/JWT prima della callback
• Rimozione automatica di https:// dagli URL nella configurazione OAuth/JWT per prevenire errori di configurazione

Miglioramenti al Playground API

• Nuovo endpoint della Search API per creare agenti e server MCP sopra la tua documentazione
• I file openapi e asyncapi ora sono serviti ai percorsi specificati (ad es. https://mydocsurl.extension/{openapi-or-file-name}.json)
• Ora puoi usare il campo x-mint nei file OpenAPI per sovrascrivere campi generati, personalizzare il contenuto introduttivo o modificare gli URL degli endpoint negli esempi di codice
• x-mcp ora è x-mint.mcp nelle configurazioni OpenAPI per controllare quali route sono esposte come strumenti MCP

Aggiornamenti all’Assistente

• Corretto un problema per cui il menu delle azioni (con opzioni come copia e pollice in su) per i messaggi meno recenti scompariva quando ne arrivavano di nuovi in streaming
• Migliorata l’accessibilità delle pagine annidate /mcp/... dopo il rilascio dei server MCP ospitati della scorsa settimana

Prestazioni e affidabilità

• Tutte le risorse immagine e video presenti nel tuo repository di documentazione ora sono servite al percorso appropriato sul tuo dominio. Ad esempio, se nel tuo repo hai /assets/marketing/my-logo.png, sarà disponibile su https://mydocsurl.extension/assets/marketing/my-logo.png.
• Il campo email nella schermata di accesso della dashboard di Mintlify ora ha l’autofocus, così puoi iniziare a digitare immediatamente (miglioria della qualità della vita)
• Sia domini personalizzati sia sottodomini in Redis per migliorare le prestazioni nei tempi di caricamento della navigazione (~50 ms di riduzione della latenza)
• Aggiunta logica di retry per le esportazioni PDF per migliorare l’affidabilità
• Corretto il popup del consenso ai cookie che riappariva dopo l’accettazione o il rifiuto—ora la prima selezione viene rispettata
• Corretta la copia di una pagina negli appunti su Safari specificando un type MIME in navigator.write

Miglioramenti tecnici

• Correzioni della CLI per Windows e pnpm, oltre a test CI per prevenire regressioni
• Migliorato l’output dei log degli errori—un miglioramento della qualità della vita per il nostro team di ingegneria durante il debugging
• Correzioni minori all’azione CI di broken-link quando i file contentDirectory sono assenti
• Corretta una regressione causata dalle correzioni ai deployment di anteprima protetti da autenticazione della scorsa settimana, in cui la scheda attiva non veniva impostata correttamente nell’interfaccia di navigazione
• Corretto il mancato applicarsi del colore di sfondo chiaro del tema alle icone della scheda attiva
• Corretto un problema per cui, cambiando il tipo di autenticazione nella dashboard, questo veniva aggiornato e poi tornava al tipo precedentemente salvato—ora la nuova selezione persiste dopo il salvataggio
• Miglioramenti interni alla DX per clienti enterprise con librerie UI personalizzate—ora per noi è più facile includere i tuoi componenti e soddisfare le richieste in tempi più brevi

​

July 27 - August 2

Improvements

Miglioramenti all’autenticazione

• Miglioramenti allo sviluppo locale dell’autenticazione, per abilitare uno sviluppo più rapido delle funzionalità di auth e la correzione di bug in quest’area del prodotto
• Deployment di anteprima ora disponibili per i siti protetti da autenticazione
• Corretto il comportamento dei redirect per riportare gli utenti alla pagina originale dopo l’autenticazione
• Corretto il pulsante di logout per l’autenticazione completa (in precedenza funzionava solo con l’autenticazione parziale)

Miglioramenti al Playground API

• Corretto il caricamento di file multipart/form-data nel Playground API
• Corretto il comportamento dei link di ancoraggio in modo che, al clic, aggiornino l’URL senza scorrere in cima alla pagina
• Corrette le problematiche dei link di ancoraggio nelle tab annidate

Aggiornamenti all’Assistente

• Nuova Assistant API per integrarlo nei tuoi prodotti, compatibile con l’AI SDK
• Aggiunto il pulsante Copia alle risposte della chat
• Corretto un problema con il tentativo di reinvio dei messaggi nell’assistente
• Miglioramenti al prompt predefinito dell’assistente per renderlo meno prolisso di default

Prestazioni e affidabilità

• Ricerca più reattiva e accurata interrompendo le richieste con debounce mentre digiti
• Provisioning di risorse per un nuovo CDN: prevedi a breve tempi di caricamento migliori per immagini e pagine
• Corretti bug nel rendering di diagrammi Mermaid complessi come i grafici GANTT
• Corretti bug della CLI su Windows per migliorare la stabilità e aggiunti test per prevenire regressioni

Miglioramenti tecnici

• Aggiunto OpenTelemetry per le trace nelle applicazioni NextJS per migliorare il time to first byte per i clienti
• Migrazione da Octokit a GitHub API Client per migliorare la latenza nell’esperienza dell’Editor web
• Corretti meta tag duplicati per OpenGraph
• Aggiornato MongoDB dalla versione 6 alla 7 per prestazioni migliori e nuove funzionalità

​

July 2025

New releasesImprovements

App Slack

• Accesso senza attriti: il bot risponde ai DM, alle @menzioni e a qualsiasi domanda nel tuo canale #ask-ai
• Configurazione con un clic: installa direttamente dalla tua dashboard Mintlify in pochi secondi
• Risposte contestuali: cerca in tutta la tua documentazione per fornire risposte pertinenti e accurate
• Riduci le interruzioni del supporto: trasforma le domande quotidiane in risposte immediate e self-service

Scopri di più nella nostra guida all’app Slack.

Server MCP ospitati

Effettua il deployment di server Model Context Protocol (MCP) ospitati direttamente tramite Mintlify per integrarti con strumenti di AI come Claude, Cursor e altri. Scopri di più nella nostra guida MCP.

Aiuta gli utenti a connettere rapidamente il tuo server MCP a Cursor o VS Code da qualsiasi pagina della tua documentazione tramite il menu contestuale. Vedi Menu contestuale per maggiori informazioni.

Miglioramenti ai blocchi di codice

• Evidenziazione della sintassi migliorata
• Aggiunte più opzioni di personalizzazione, inclusi modalità focus, blocchi di codice espandibili, reattività alla modalità scura e chiara, menu a discesa della lingua, numerazione delle righe e icone

​

June 2025

New releasesImprovements

Aggiornamenti all’assistente AI

• Accuratezza migliorata tramite RAG agentico con chiamata di tool
• Fornisce link navigabili alle pagine di riferimento così che gli utenti possano andare direttamente alla fonte delle risposte
• Scorciatoia per copiare gli esempi di codice generati dall’assistente
• Scorciatoia “Ask AI” sui blocchi di codice nella documentazione per generare spiegazioni dall’assistente

Scopri di più nella documentazione dell’assistente.

Changelog sottoscrivibili

• Genera automaticamente un feed RSS dalle pagine del changelog
• Integra gli aggiornamenti abilitati RSS con Slack, email e altri strumenti

Scopri di più nella nostra nuova Guida al changelog

​

May 2025

Improvements

Aggiornamenti di stabilità del Playground API

• Cerca per trovare un endpoint
• Indica un endpoint deprecato con un tag
• Nascondi le pagine API generate automaticamente dalla navigazione
• Carica file multipart o form data

Scopri di più nella documentazione del Playground API.

mint update

Ora puoi usare mint update per aggiornare la tua CLI.

​

April 2025

New releasesImprovements

Editor web 3.0

Usabilità rinnovata nell’editor WYSIWYG.

Miglioramenti principali

• Cerca i nomi dei file con la scorciatoia ⌘ + P
• Le pagine si caricano 10x più velocemente
• Tempi di caricamento più rapidi durante la ricerca di un branch
• Scheda Opzioni pagina per configurare layout, titolo e metadati per la SEO
• Barra degli strumenti fluttuante quando evidenzi il testo

Correzioni aggiuntive

• Corretto il margine superiore per i componenti del changelog
• Migliorata l’affidabilità del comportamento del clic destro
• Dopo aver cliccato Pubblica, rimani sulla stessa pagina invece di essere portato a uno stato vuoto
• Colori standardizzati nelle icone dei file
• Migliorata l’affidabilità dopo aver selezionato nuovi branch più volte di seguito
• Rimosso il modo Diff
• Maggiore coerenza durante la creazione di una nuova cartella dal menu a discesa
• Risolto il problema con le citazioni che ne creavano di ulteriori quando si tentava di deselezionare

Traduzioni AI in beta

Traduci tutta la tua documentazione con l’AI. Scopri di più.

Esporta documentazione in PDF in beta

Esporta tutta la tua documentazione, una sottodirectory o una singola pagina come PDF.

Supporto per hook React

Porta interattività nella tua documentazione. Tutti gli hook React standard sono automaticamente disponibili nei tuoi file MDX. Scopri di più.

​

March 2025

New releasesImprovements

Generatore di server MCP

Genera server MCP affinché le applicazioni AI possano interagire con la tua documentazione o le tue API. I contenuti testuali vengono generati automaticamente come server MCP e puoi generare un server MCP dalla tua specifica OpenAPI con un clic. Consulta la documentazione per iniziare con MCP.

Miglioramenti

• Tagga gli aggiornamenti del changelog così gli utenti finali possono filtrare le novità
• Sonnet-3.7 supportato per AI Chat. Configura il tuo modello preferito dalla dashboard
• Cambia il nome del tuo deployment direttamente nelle impostazioni della dashboard

Correzioni di bug

• Corrette le immagini OG
• Risolta l’incoerenza dello stile delle icone per gli anchor senza container
• Migliorati piccoli dettagli di stile del bordo della dashboard per la responsività mobile-tablet-desktop
• Mostra esempi di codice anche in modalità semplice per il Playground API
• Supportata la scorciatoia “command + k” per la ricerca nell’editor web
• I blocchi di codice all’interno dei callout si espandono per riempire la larghezza dell’area del callout

​

February 2025

New releasesImprovements

Nuovo schema di configurazione docs.json

Abbiamo introdotto un nuovo schema docs.json in sostituzione di mint.json, per supportare un versioning multilivello migliore, una comprensione visiva più immediata e una terminologia più coerente. Per maggiori informazioni su cosa è cambiato, consulta il nostro blog.

Esegui l’upgrade da mint.json a docs.json con i seguenti passaggi:

1. Assicurati che la tua CLI sia all’ultima versione

npm i mint@latest -g

1. Nel tuo repository della documentazione, esegui

mint upgrade

1. Elimina il vecchio file mint.json e fai push delle modifiche

Controlli CI

Esegui automaticamente il lint della documentazione per trovare link interrotti, individuare problemi di ortografia e grammatica o applicare stili di scrittura con la tua configurazione di Vale. Scopri di più nelle nostre docs.

Supporto .md per LLM

Tutte le pagine della documentazione sono ora automaticamente disponibili come file Markdown in chiaro: basta aggiungere .md all’URL. Questo rende più facile per gli LLM acquisire singole pagine della documentazione.

Più temi

Nuovi temi predefiniti per modificare il look & feel della documentazione. Configurali tramite il file docs.json.

Ora disponibili:

• Maple
• Palm
• Willow

Altri miglioramenti

• Guida alla scrittura tecnica: best practice per la redazione di documentazione tecnica, incluse analisi del pubblico, tipi di contenuto e consigli di scrittura.
• Componente Dropdown: organizza la navigazione con un menu a discesa, oltre a tab e anchor.
• Correttore di sintassi AI: l’Editor web rileva eventuali errori di parsing e usa l’AI per suggerire correzioni.

​

January 2025

Improvements

Miglioramenti all’Assistente AI

• Nuova UI con pagina chat dedicata e prompt precompilati
• Miglioramenti di stabilità, ad es. correzioni di bug che modificavano il file sbagliato o nessun file
• Conoscenza più solida per aggiungere e modificare componenti
• Miglioramenti all’editing del file docs.json

Autenticazione parziale

Personalizza l’accesso a qualsiasi pagina o sezione in base alle autorizzazioni dell’utente. Supporta l’integrazione con il tuo sistema di autenticazione.

Playground API rinnovato

Abbiamo rivisto il design e le prestazioni del Playground API. Gli aggiornamenti includono:

• Espansione dei dettagli più semplice per ottenere una panoramica di un campo
• Design annidato più intuitivo, ad es. aggiunta o eliminazione di elementi
• Tempi di risposta più rapidi

Miglioramenti di qualità

• Supporto per richiedere l’autenticazione per accedere ai Deployment di anteprima

​

December 2024

Autenticazione

Rendi private le docs configurando l’autenticazione tramite JWT, OAuth o una password universale. Con questa protezione, puoi creare una knowledge base interna o impedire ai concorrenti di vedere la documentazione.

​

November 2024

AI Writer

Ora puoi chiedere all’IA di apportare modifiche alla tua documentazione, con il contesto di tutta la documentazione esistente. Inserisci un prompt e il writer proporrà le modifiche generando una pull request.

Aggiornamento dell’integrazione con GitLab

Abbiamo migliorato il supporto per la sincronizzazione con GitLab, ad esempio abilitando aggiornamenti automatici e deployment di anteprima. Consulta la nostra documentazione su GitLab per iniziare.

Editor web

Abbiamo rinnovato il nostro Editor web, così ora puoi aggiornare la documentazione con un’esperienza WYSIWYG completa, sincronizzata con il markdown.

Consulta la nostra documentazione per iniziare con l’Editor web.

Supporto a /llms.txt

Tutte le istanze della documentazione sono ora automaticamente disponibili su /llms.txt e /llms-full.txt, così gli LLM possono acquisire facilmente la tua documentazione. Per ulteriori informazioni, leggi la documentazione sul nuovo standard llms.txt.

Localizzazione

Ora puoi localizzare la tua documentazione, in modo analogo al versioning. Aggiungi un locale a una versione e anche i contenuti fissi in Mintlify, come “Questa pagina è stata utile?”, verranno adattati al locale.

Miglioramenti della qualità

• Restituisce i risultati di chat e ricerca in base alla versione che l’utente sta visualizzando
• Autentica gli utenti con OAuth, oltre a JWT o token di sessione condivisa.

​

October 2024

Changelogs

Abbiamo introdotto un nuovo Update component per rendere più semplice mostrare e comunicare gli aggiornamenti (come questo) ai tuoi utenti.

Evidenziazione delle righe di codice

Ora puoi evidenziare le righe di codice nella tua documentazione per mettere in risalto le parti importanti aggiungendo un commento speciale dopo l’identificatore della lingua. Usa le parentesi graffe {} e specifica numeri di riga o intervalli separati da virgole.

Line Highlighting Example

const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();

```javascript Line Highlighting Example {1,3-5}
const greeting = "Hello, World!";
function sayHello() {
  console.log(greeting);
}
sayHello();
```

Blocchi di codice in modalità chiara

I blocchi di codice ora hanno una variante in modalità chiara, attivabile aggiungendo quanto segue al tuo docs.json:

"codeBlock": {
  "mode": "auto"
}

Footer avanzato

Ora puoi aggiungere più link al footer standard. Questo upgrade offre maggiore coerenza tra le landing page e la documentazione, oppure una personalizzazione più ampia se vuoi mettere in evidenza pagine specifiche come i social o i log di stato.

Filtra la ricerca in base all’utente corrente

Quando la personalizzazione è abilitata, i risultati di ricerca vengono ora filtrati in base all’utente attualmente connesso, così da mostrare solo i contenuti pertinenti.

Prompt personalizzati per la chat AI

Ora puoi personalizzare i prompt per la chat AI. Contatta il supporto se desideri personalizzarli.

Miglioramenti alla dashboard

• Aggiunta la possibilità di impostare il dominio personalizzato su /docs direttamente dalle impostazioni della dashboard.
• Unificate le pagine di login e signup per ridurre attriti e confusione.
• Implementato il flusso di login discovery, così gli utenti membri di più organizzazioni possono ora passare da una all’altra.
• Aggiunto l’accesso con Google OAuth.
• Aggiunta la possibilità di creare un nuovo deployment dalle impostazioni della dashboard.

Correzioni di bug

• Ora è possibile usare gli slash iniziali nella navigazione.
• Ora è possibile modificare i file CSS e JS nell’Editor web.
• Corretto suggestEdit, che non veniva mostrato anche quando abilitato.
• Corretta la navigazione da tastiera per Search e Chat, consentendo l’uso delle frecce su e giù per scorrere i risultati.
• Impedito ai motori di ricerca di eseguire la scansione delle pagine protette da autenticazione utente.
• La cache viene rivalidata quando un’organizzazione viene eliminata.
• Ora utilizziamo il parser Scalar OpenAPI per analizzare le definizioni OpenAPI, migliorando le prestazioni, risolvendo problemi di parsing e fornendo messaggi di errore più chiari.
• Le descrizioni di livello superiore sono ora supportate nelle pagine di riferimento API autogenerate dalle definizioni OpenAPI.
• Aggiunto supporto inline-style per le icone.
• Corretto l’effetto di pop-in del CSS personalizzato nella documentazione.
• Mostrato correttamente lo stile del codice inline in combinazione con i link.
• Mantieni la posizione di scorrimento quando fai clic sul pulsante Indietro del browser.

​

September 2024

Font personalizzati

Personalizza i font della tua documentazione utilizzando un font tuo ospitato su un CDN oppure scegliendo tra i Google Fonts, per allineare la documentazione al tuo brand.

Immagini nei componenti Card

Aggiungi la proprietà img a una card per visualizzare un’immagine nella parte superiore della card. Scopri di più qui.

Miglioramenti delle prestazioni

Per progetti di grandi dimensioni (~3.000 file), la fase di download per gli aggiornamenti della documentazione è ora ~440x più veloce, con una riduzione dei tempi del 99,8%. In generale, i download dei file durante gli aggiornamenti sono ora ~5,5x più veloci, con una riduzione dei tempi dell’81,8%.

Miglioramenti SEO

Abbiamo corretto sia il layout mobile sia quello desktop della nostra documentazione, rendendoli più SEO-friendly — inclusa l’aggiunta di tag aria appropriati alla navbar e agli elementi toggle.

Miglioramenti della dashboard

• Migrazione all’App Router nella dashboard.
• Le analisi di ricerca sono ora disponibili nella dashboard.
• Aggiunta alla dashboard la funzionalità di eliminazione di un’organizzazione.
• Pubblicata l’interfaccia di connessione a GitLab.
• Corretto l’errore nei dati di analytics.
• Gli add-on ora possono essere acquistati direttamente dalla dashboard.

Correzioni di bug

• Corretto un bug per cui la barra superiore non si estendeva alla larghezza dello schermo quando era in modalità personalizzata e il layout della sidebar era sidenav.
• Corretto il posizionamento relativo del widget AI.

Altro

• Troubleshooting per pagine API: le pagine API possono essere complesse, quindi abbiamo elencato i problemi comuni per aiutarti a risolverli rapidamente — Leggi la documentazione

​

August 2024

Pagine di riferimento OpenAPI

• Gli endpoint definiti da OpenAPI che sono complessi e ricorsivi sono ora più piccoli del 98%.
• Ora mostriamo additionalProperties nelle pagine OpenAPI.

Caricamento file nel Playground API

Per impostazione predefinita, le richieste del Playground API sono instradate tramite proxy da Mintlify. Ora puoi usare disableProxy per disabilitare questo comportamento e supportare tipi di richiesta come il caricamento di file.

• Scopri di più sulle configurazioni API

Miglioramenti SEO per mobile

Abbiamo corretto il layout mobile della nostra documentazione, rendendolo più SEO-friendly — inclusa l’aggiunta di tag aria appropriati agli elementi.

Modulo di supporto

Abbiamo aggiunto un modulo di supporto più dettagliato alla dashboard di Mintlify. Ora puoi inviare un modulo per metterti in contatto con noi.

Correzioni di bug

• Corretto un bug per l’integrazione con Segment.
• Ora mostriamo messaggi di errore più granulari per i permessi GitHub quando si interagisce con l’editor.
• Corretto un bug per cui la navigazione non si espandeva correttamente quando veniva utilizzato un link diretto.

​

July 2024

Widget AI

Per gli utenti Pro, abbiamo introdotto Mintlify Widget, un’estensione della tua documentazione per rispondere alle domande dei tuoi utenti quando e dove le pongono. Puoi aggiungere questo chatbot basato sull’AI a qualsiasi pagina web: la tua landing page, all’interno del tuo prodotto o sulle tue pagine di documentazione esistenti.

• Leggi l’annuncio sul blog

Piano Pro

Abbiamo anche aggiornato i nostri piani tariffari per una migliore personalizzazione e scalabilità.

• Leggi l’annuncio sul blog

Sincronizzazione degli esempi di codice nel Playground API

Quando navighi nella documentazione API, l’esempio di codice selezionato ora si sincronizza tra le tue pagine.

Insights

Attualmente in beta, questa funzionalità riassume le domande e i pattern più comuni degli utenti in report facili da consultare, con suggerimenti basati sull’AI su come migliorare il tuo prodotto.

​

June 2024

Novità della Launch Week

• Temi: personalizza lo stile con temi preconfigurati. Ti basta aggiungere il tema Quill, Prism o Venus al file docs.json e lo stile della documentazione verrà aggiornato.
• Search V2: interroga direttamente descrizioni e titoli degli endpoint OpenAPI per raggiungere le pagine di API Reference, escludi le pagine nascoste dalla ricerca e usa la nostra barra di ricerca aggiornata.
• Branching nell’Editor web: crea branch nel nostro Editor web senza un IDE.
• Personalizzazione utente: autentica gli utenti con Shared Session o JWT per mostrare contenuti personalizzati, ad esempio precompilare le chiavi API o mostrare contenuti specifici per i clienti.
• Aggiornamenti all’automazione OpenAPI: per popolare automaticamente le pagine del Playground API, puoi aggiungere un campo openapi a un oggetto negli array tabs o anchors nel docs.json.

​

May 2024

Okta SSO

Ora supportiamo l’accesso tramite Okta SAML e OIDC.

API REST di Mintlify

Attiva aggiornamenti della documentazione in modo programmatico.

​

April 2024

Modalità personalizzata

Aggiungi una configurazione ai metadati per rimuovere tutti gli elementi tranne la barra superiore. Casi d’uso di esempio:

• Crea una landing page globale personalizzata con componenti personalizzati
• Aggiungi video a schermo intero o gallerie di immagini
• Incorpora elementi demo iFrame personalizzati per aggiungere interattività alla tua documentazione

Dai un’occhiata alla nostra documentazione sulla Modalità personalizzata.

​

March 2024

Mintlify MDX per VSCode

Inserisci snippet dei nostri componenti e callout predefiniti senza lasciare VSCode. Installa l’estensione qui.

​

February 2024

Miglioramenti di qualità

• Aggiornamenti alla dashboard: visualizza i log degli aggiornamenti per vedere cosa è cambiato e lo stato di un aggiornamento, passa tra progetti Mintlify per gestire i deployment
• Versioning con tab pienamente supportato
• Reindirizzamenti wildcard ora supportati
• Rilevamento errori CLI: ora mostriamo la posizione del frontmatter non valido quando si verificano problemi di parsing durante lo sviluppo locale

​

January 2024

Novità della Launch Week

• Deployment di anteprima: quando crei una pull request, genereremo un link univoco che mostra un’anteprima live dell’aspetto della tua documentazione in produzione. Puoi condividere questo link con i membri del team.
• Snippet V2: ora supportiamo componenti e variabili completamente riutilizzabili per gli snippet.
• Motore MDX open source: abbiamo esposto due API — getCompiledMdx e MDXComponent — così puoi accedere al markdown di Mintlify e all’evidenziazione della sintassi del codice. Contributi al progetto benvenuti.
• Approfondimenti da AI Chat: segmenta la cronologia delle chat per data, aumenta la quota di AI Chat dalla dashboard e verifica la frequenza di comparsa di una specifica query.