Mises à jour produit

Nouvelles versions et améliorations

​

31 août - 13 septembre

New releasesImprovements

Principales versions

• Amélioration majeure : pages suggérées par l’IA sur les 404, quand quelqu’un arrive sur un lien mort → l’agent IA lit le chemin → suggère des pages sémantiquement similaires
• Version majeure : la recherche web de l’Assistant peut désormais inclure des sources externes
  Remarque : contactez-nous pour activer cette fonctionnalité sur votre site.

Assistant et MCP

• Correction d’un bug où l’Assistant était incorrectement soumis à une limitation de débit parce que la fenêtre temporelle ne glissait pas correctement
• Correction d’un bug d’appel d’outil de l’Assistant afin de gérer correctement les blocs text vides
• Correction d’un bug où les noms de serveur MCP concaténés avec les appels d’outils dépassaient parfois la limite de 60 caractères imposée par les clients MCP
• Correction d’un bug où le menu de l’Assistant avait une hauteur plusieurs fois supérieure à la fenêtre et défilait indéfiniment
• Correction d’un bug où les montants de dépenses de l’Assistant pouvaient s’afficher avec plus de deux décimales dans le tableau de bord

Éditeur web et déploiements

• Renforcement de la sécurité de l’éditeur : seuls les utilisateurs disposant des « write permissions » sur le dépôt Git connecté peuvent effectuer des modifications
• Correction d’un bug où les déploiements de prévisualisation ne fonctionnaient pas pour les branches contenant = dans le nom
• Correction d’un bug où les noms de branches longs débordaient des modales lors de la création de déploiements de prévisualisation
• Amélioration de l’expérience : le paramètre de requête email préremplit désormais le champ dans les invitations d’inscription
• Correction d’un bug où la copie d’une page depuis le menu contextuel ne fonctionnait pas sur Safari

Bac à sable API et navigation

• Les multiples codes de réponse du Bac à sable API s’affichent désormais dans un menu déroulant stylisé contrôlé, au lieu du menu déroulant système par défaut lorsqu’il est focalisé
• Vous pouvez maintenant utiliser le champ expanded sur les groupes de navigation dans votre docs.json pour qu’ils soient ouverts par défaut

SEO et interface

• Correction d’un bug où les favicons n’apparaissaient pas dans les moteurs de recherche, en les servant depuis la même URL que le site de documentation de chaque site concerné
• Correction d’un bug où les intégrations YouTube clignotaient au chargement
• Correction d’un bug où l’extension du menu de feedback pour inclure des réponses écrites provoquait un décalage de mise en page avec la table des matières
• Correction d’un bug où le texte dépassait au-dessus de la barre supérieure sur le thème Maple lorsqu’on fermait la bannière de notification
• Amélioration des thèmes Maple et Willow avec l’ajout de boutons connexion/déconnexion dans la barre latérale pour un accès plus simple

Analyses et exports

• Correction de problèmes de fiabilité avec la vue d’analytique de l’Assistant et les exports
• Les exports d’analytique de l’Assistant sont désormais exécutés en arrière-plan et envoyés par email pour une expérience plus fiable

​

August 24 - August 30

Improvements

Version majeure : collecte de retours améliorée

• Amélioration majeure : Les lecteurs peuvent désormais fournir des retours plus détaillés après avoir sélectionné pouce levé/baissé, avec des options et des commentaires écrits. Vous pouvez également collecter des retours sur les blocs de code et consulter toutes les réponses dans les analyses de votre tableau de bord.
  Remarque : contactez-nous pour activer cette fonctionnalité sur votre site.

Améliorations de la navigation et du confort d’utilisation

• Amélioration de confort pour ignorer les barres obliques finales et doubles afin que vous n’ayez pas à vous soucier de les renseigner exactement comme il faut dans votre docs.json
• Vous pouvez maintenant ajouter un attribut noAnchor à vos balises HTML h1-6 pour éviter qu’elles n’aient un lien d’ancrage
• Le thème Palm dispose désormais d’un sélecteur de langue flottant en bas à gauche, similaire à l’approche de Stripe
• Ajout d’un nouveau champ dans le docs.json, appelé drilldown, qui vous permet de contrôler si les utilisateurs sont ou non dirigés vers la première page d’un groupe de navigation lorsque le groupe est développé
• Amélioration de confort pour faire alterner les styles des listes ordonnées imbriquées entre décimal/romain et alphabétique

Corrections de bugs et fiabilité

• Correction d’un bug où les liens d’ancrage de position de défilement ne fonctionnaient pas correctement lorsqu’il y avait des composants JS sur une page
• Correction d’un bug où Google indexait des fichiers *.md bruts parce qu’il manquait un en-tête x-robots-tag noindex
• Correction d’un bug avec OAuth sur la documentation protégée où vous n’étiez pas redirigé vers votre page de départ après avoir terminé le parcours avec succès
• Correction d’un bug sur les aperçus de documentation protégée par authentification où vous ne pouviez pas voir l’intégralité de la barre de navigation
• Corrections de bugs concernant la gestion des SVG avec notre nouveau CDN d’images

Améliorations des composants et du style

• Ajout d’un nouveau sélecteur CSS pour des styles personnalisés sur SidebarNavGroupDivider
• De nouveaux tests de régression pour les pages API définies en MDX avec des règles de sécurité assureront un degré de stabilité plus élevé

Améliorations des performances

• Amélioration des performances en déplaçant le CSS KaTeX de cdnjs vers notre propre CDN sur CloudFront afin de réduire la latence

​

August 17 - August 23

Improvements

Améliorations de la gestion des images

• Amélioration majeure : Les images ne provoquent plus de décalage de mise en page par défaut, même lorsque les attributs width et height ne sont pas spécifiés — le dimensionnement automatique empêche les sauts de contenu lors du chargement des pages
• Tous les fichiers statiques de votre dépôt (PDF, TXT, XML, etc.) sont désormais automatiquement téléversés et servis lors du déploiement, assurant une couverture complète des ressources

Améliorations de l’Éditeur web et du déploiement

• Correction du flux de création de branche dans l’Éditeur web pour naviguer correctement vers les nouvelles branches créées et y rester
• Boîte de dialogue de résolution de conflits de fusion améliorée avec une gestion correcte de l’échappement, plus besoin de recharger la page pour fermer les conflits
• Optimisation des performances du flux de mise à jour en invalidant le cache uniquement des pages modifiées lors des mises à jour partielles, réduisant les temps de déploiement

Améliorations de l’authentification et de la navigation

• Nouveau support de l’authentification sur des sous-répertoires personnalisés : si vous servez la documentation à https://yourdomain.com/docs, l’authentification fonctionne désormais de manière fluide
• Correction d’un bug d’affichage de la barre latérale qui apparaissait de manière incorrecte lorsqu’un seul lien était configuré
• Refonte complète de la navigation mobile : boutons centrés avec marges/espacements appropriés, espacement amélioré dans les menus déroulants, suppression des séparateurs et marges inutiles pour les sections vides, et correction des problèmes d’écart/espacement du thème Maple

Corrections de composants et de style

• Résolution d’un problème de conversion des balises <h1-6> qui les transformait incorrectement en composants Heading et perturbait le style personnalisé
• Ajout d’un interrupteur de configuration de l’Assistant en un clic dans le tableau de bord pour en faciliter la gestion

Améliorations techniques et fiabilité

• Système de journalisation amélioré pour les flux de mise à jour, permettant un débogage et une résolution des problèmes plus rapides
• Correction de la limitation de débit GitHub pour les clients avec plus de 10 spécifications OpenAPI/AsyncAPI en passant de la récupération de fichiers individuels au clonage du dépôt
• Fiabilité de l’Assistant améliorée avec un LLM de secours, une meilleure gestion des erreurs de limitation de débit et une fonctionnalité de recherche plus robuste

​

August 10 - August 16

Improvements

Optimisations des performances et du build

• La transpilation MDX a désormais lieu au moment du déploiement plutôt qu’à chaque chargement de page dans les environnements serverless NextJS non mis en cache, améliorant le time to first byte pour les pages non mises en cache.
• Le hachage basé sur le contenu empêche la retranspilation lorsque le MDX n’a pas changé, réduisant d’environ 50 % les temps des workflows de mise à jour pour les clients avec un grand nombre de pages (les déploiements de plus de 5 minutes devraient être approximativement divisés par deux)
• L’affichage des Déploiements de prévisualisation dans le tableau de bord est désormais plus rapide grâce à l’ajout d’index de base de données et à la parallélisation des requêtes dans notre backend
• Réduction de la taille des pages en éliminant les données navigation dupliquées dans la charge utile rsc de chaque page — gains de performance particulièrement visibles avec un grand nombre de pages ou des structures de navigation complexes
• Un préchargement plus agressif permet des chargements de page instantanés plus fréquemment

Améliorations du Bac à sable API et d’OpenAPI

• La conversion OpenAPI vers MCP a été déplacée vers le backend, permettant aux serveurs MCP hébergés de contenir des outils (attendez-vous bientôt à une documentation et des options de configuration plus claires)
• Ajout de la prise en charge de Ruby dans le Bac à sable API
• Nous avons ajouté une fonctionnalité qui permet désormais de spécifier des pages API en utilisant uniquement votre docs.json sans créer de nouveaux fichiers MDX.
• Prise en charge des pages webhook dans la navigation de la documentation à partir des spécifications OpenAPI
• Contexte de modèle IA optimisé en supprimant les spécifications de liens d’ancrage des liens Markdown lors de la navigation vers Anthropic, OpenAI ou d’autres fournisseurs

Améliorations de l’Éditeur web

• La création et le renommage de fichiers enregistrent désormais les modifications lors d’un clic à l’extérieur au lieu d’exiger l’appui sur la touche Entrée
• Correction de la navigation entre branches où la modification de l’URL vers une branche spécifique redirigeait vers la dernière branche active au lieu de la destination souhaitée
• Encodage correct en URL des titres de branche contenant / pour éviter les ruptures de navigation
• Correction du raccourci de lien Ctrl+K dans l’Éditeur du tableau de bord monorepo qui préfixait le chemin du dépôt de docs et créait des liens cassés

Analytique et intégrations LLM

• Prise en charge de llms.txt et llms-full.txt personnalisés — ajoutez-les à la racine du dépôt de docs pour les servir aux endpoints /llms.txt et /llms-full.txt pour la personnalisation LLM
• Ajout de l’intégration analytique Hightouch
• Suivi analytique du Menu contextuel amélioré (affichage dans le tableau de bord bientôt disponible)
• Ajout de tests e2e pour llms.txt et llms-full.txt afin d’assurer une diffusion correcte

Améliorations des Composants et du style

• Prise en charge de classnames personnalisés dans les balises h{1-4} pour appliquer des styles de titres personnalisés
• Correction du rendu des balises h{1-4} en tant que composants Heading avec des chips en mode page personnalisée
• Ajout de sélecteurs CSS aux breadcrumbs pour un ciblage CSS personnalisé
• Correction des images Open Graph étirées en analysant les dimensions pour maintenir les proportions à une hauteur de 56 px
• Correction de VSCode en VS Code dans le menu contextuel lorsqu’il est activé
• Correction des titres à l’intérieur des composants personnalisés apparaissant dans la table des matières en plus des titres sémantiques

Corrections de bugs et fiabilité

• Correction des problèmes de rendu PDF avec certains titres de page en assainissant les caractères qui causent des problèmes de génération
• Résolution de l’erreur CLI Cannot convert undefined or null to object lors de la rencontre de fichiers JSON OpenAPI vides
• Correction des métabalises Open Graph docs.json personnalisées écrasées par celles générées
• Correction des clics sur le bouton du flux RSS lors de l’arrivée sur des liens d’ancrage en utilisant origin + pathname pour les liens RSS
• Amélioration de la vitesse de téléchargement du CLI en supprimant les sourcemaps

Améliorations techniques

• Ajout de tests visuels au pipeline CI pour une détection plus précoce des régressions
• Amélioration de la gestion des erreurs et des capacités de débogage
• Couverture de tests complète pour les nouvelles fonctionnalités et les cas limites

​

3 août - 9 août

Improvements

Améliorations de l’authentification

• Accès public au niveau du groupe : rendez publics des groupes entiers de pages via docs.json afin d’éviter d’ajouter public: true à chaque page (en savoir plus)
• Prise en charge de logoutURL dans la configuration OAuth pour supprimer les cookies en amont et finaliser la déconnexion
• En cas d’erreur OAuth, les utilisateurs sont redirigés vers le logoutURL spécifié pour relancer le flux d’authentification
• Correction d’un bref affichage d’une erreur 500 durant les flux OAuth/JWT avant le callback
• Suppression automatique de https:// des URL dans la configuration OAuth/JWT pour prévenir les erreurs de configuration

Améliorations du Bac à sable API

• Nouveau endpoint Search API pour créer des agents et des serveurs MCP au-dessus de votre documentation
• Les fichiers openapi et asyncapi sont désormais servis à leurs chemins spécifiés (p. ex. https://mydocsurl.extension/{openapi-or-file-name}.json)
• Vous pouvez désormais utiliser le champ x-mint dans vos fichiers OpenAPI pour remplacer des champs générés, personnaliser le contenu d’introduction ou modifier les URL d’endpoint dans les exemples de code
• x-mcp est désormais x-mint.mcp dans les configurations OpenAPI pour contrôler quelles routes sont exposées comme outils MCP

Mises à jour de l’Assistant

• Correction d’un problème où le menu d’actions (options comme copier et pouce levé) des anciens messages disparaissait lorsque de nouveaux messages arrivaient en flux
• Correction de l’accessibilité des pages imbriquées /mcp/... après la mise en ligne des serveurs MCP hébergés la semaine dernière

Performances et fiabilité

• Toutes les ressources image et vidéo présentes dans votre dépôt de documentation sont désormais servies au chemin approprié sur votre domaine. Par exemple, si vous avez /assets/marketing/my-logo.png dans votre dépôt, elle sera disponible à https://mydocsurl.extension/assets/marketing/my-logo.png.
• Le champ e-mail sur l’écran de connexion du tableau de bord Mintlify a désormais l’autofocus pour commencer à saisir immédiatement (amélioration du confort)
• Stockage des domaines personnalisés et des sous-domaines dans Redis pour améliorer les performances des temps de chargement de la navigation (~50 ms de latence en moins)
• Ajout d’une logique de nouvelle tentative pour les exports PDF afin d’améliorer la fiabilité
• Correction de la fenêtre de consentement aux cookies qui réapparaissait après acceptation ou rejet — la première sélection est désormais respectée
• Correction de la copie d’une page dans le presse-papiers sur Safari en spécifiant un type MIME dans navigator.write

Améliorations techniques

• Corrections de bugs de la CLI pour Windows et pnpm, plus des tests CI pour prévenir les régressions
• Amélioration de la sortie des journaux d’erreurs — un gain de confort pour notre équipe d’ingénierie lors du débogage
• Corrections mineures de l’action CI de liens cassés lorsque les fichiers contentDirectory sont manquants
• Correction d’une régression causée par les correctifs de prévisualisation protégée par authentification de la semaine dernière où l’onglet actif n’était pas correctement défini dans l’UI de navigation
• Correction de la couleur d’arrière-plan clair du thème qui ne s’appliquait pas aux icônes de l’onglet actif
• Correction d’un problème où la modification du type d’authentification dans le tableau de bord se mettait à jour puis revenait au type précédemment enregistré — désormais la nouvelle sélection persiste après enregistrement
• Améliorations internes de la DX pour les clients entreprises avec des bibliothèques UI personnalisées — il nous est désormais plus facile d’inclure vos composants et de répondre à vos demandes sur des délais plus courts

​

July 27 - August 2

Improvements

Améliorations de l’authentification

• Améliorations du développement local de l’auth, permettant un développement plus rapide des fonctionnalités d’auth et des corrections de bugs dans cette partie du produit
• Déploiements de prévisualisation désormais disponibles pour les sites protégés par auth
• Correction du comportement de redirection afin de renvoyer correctement les utilisateurs vers leur page d’origine après authentification
• Correction de l’affichage du bouton de déconnexion pour l’authentification complète (auparavant ne fonctionnait que pour l’authentification partielle)

Améliorations du Bac à sable API

• Correction de l’envoi de fichiers multipart/form-data dans le Bac à sable API
• Correction du comportement des liens d’ancrage afin que le clic mette à jour l’URL sans remonter en haut de la page
• Correction des problèmes de liens d’ancrage dans les onglets imbriqués

Mises à jour de l’Assistant

• Nouvelle API de l’Assistant pour l’intégrer à vos propres produits, compatible avec l’AI SDK
• Ajout d’un bouton de copie aux réponses du chat
• Correction d’un problème avec la relance des messages dans l’Assistant
• Amélioration de l’invite par défaut de l’Assistant pour la rendre moins verbeuse par défaut

Performances et fiabilité

• Recherche plus réactive et précise en annulant les requêtes temporisées pendant la saisie
• Provisionnement des ressources pour un nouveau CDN — attendez-vous à une amélioration prochaine des temps de chargement des images et des pages
• Correction de bugs pour le rendu de diagrammes Mermaid complexes comme les diagrammes de Gantt
• Correction de bugs du CLI sur Windows pour améliorer la stabilité et ajout de tests pour prévenir les régressions

Améliorations techniques

• Ajout d’OpenTelemetry pour les traces dans l’application Next.js afin d’améliorer le time to first byte pour les clients
• Migration d’Octokit vers GitHub API Client pour réduire la latence dans l’expérience de l’Éditeur web
• Correction des balises meta dupliquées pour OpenGraph
• Mise à niveau de MongoDB de la version 6 à la 7 pour de meilleures performances et de nouvelles fonctionnalités

​

July 2025

New releasesImprovements

Application Slack

• Accès sans friction : le bot répond aux messages privés, aux @mentions et à toute question dans votre canal #ask-ai
• Configuration en un clic : installez directement depuis votre tableau de bord Mintlify en quelques secondes
• Réponses contextuelles : recherche dans toute votre documentation pour fournir des réponses pertinentes et précises
• Réduisez les interruptions du support : transformez les questions quotidiennes en réponses instantanées en libre-service

En savoir plus dans notre guide de l’application Slack.

Serveurs MCP hébergés

Déployez des serveurs Model Context Protocol (MCP) hébergés directement via Mintlify pour les intégrer à des outils d’IA comme Claude, Cursor et d’autres. En savoir plus dans notre guide MCP.

Aidez les utilisateurs à connecter rapidement votre serveur MCP à Cursor ou VS Code depuis n’importe quelle page de votre documentation via le menu contextuel. Voir Menu contextuel pour plus d’informations.

Améliorations des blocs de code

• Amélioration de la coloration syntaxique
• Ajout de davantage d’options de personnalisation, notamment le mode focus, les blocs de code extensibles, l’adaptation aux modes sombre et clair, le menu déroulant de langue, la numérotation des lignes et les icônes

​

June 2025

New releasesImprovements

Mises à jour de l’assistant IA

• Précision améliorée via un RAG agentique avec appel d’outils
• Fournit des liens navigables vers les pages référencées afin que les utilisateurs puissent aller directement à la source des réponses
• Raccourci de copie pour les exemples de code générés par l’Assistant
• Raccourci « Ask AI » sur les blocs de code dans la documentation pour générer des explications de l’Assistant

En savoir plus dans la documentation de l’Assistant.

Journaux de changements abonnables

• Génération automatique d’un flux RSS à partir des pages du journal de changements
• Intégration des mises à jour compatibles RSS avec Slack, l’e-mail et d’autres outils

En savoir plus dans notre nouveau guide Changelog

​

May 2025

Improvements

Mises à jour de stabilité du Bac à sable API

• Rechercher pour trouver un endpoint
• Indiquer un endpoint obsolète avec un tag
• Masquer les pages API générées automatiquement de la navigation
• Téléverser des fichiers multipart ou form-data

En savoir plus dans la documentation du Bac à sable API.

mint update

Vous pouvez désormais utiliser mint update pour mettre à jour votre CLI.

​

April 2025

New releasesImprovements

Éditeur web 3.0

Ergonomie de l’éditeur WYSIWYG entièrement repensée.

Améliorations majeures

• Recherchez des fichiers avec le raccourci ⌘ + P
• Les pages se chargent 10× plus vite
• Temps de chargement réduits lors de la recherche d’une branche
• Onglet Options de page pour configurer la mise en page, le titre et les métadonnées SEO
• Barre d’outils flottante lors de la sélection de texte

Corrections supplémentaires

• Correction de la marge supérieure des composants de journal des modifications
• Fiabilité améliorée du clic droit
• Après avoir cliqué sur Publier, vous restez sur la même page au lieu d’être redirigé vers un état vide
• Couleurs des icônes de fichier standardisées
• Fiabilité améliorée après la sélection de nouvelles branches à plusieurs reprises
• Suppression du mode Diff
• Plus de cohérence lors de la création d’un nouveau dossier depuis le menu déroulant
• Correction d’un problème où les blocs de citation en créaient d’autres lors de la désélection

Traductions IA en bêta

Traduisez toute votre documentation avec l’IA. En savoir plus.

Export de la documentation en PDF (bêta)

Exportez toute votre documentation, un sous-répertoire ou une page unique en PDF.

Prise en charge des hooks React

Ajoutez de l’interactivité à votre documentation. Tous les hooks React standard sont automatiquement disponibles dans vos fichiers MDX. En savoir plus.

​

March 2025

New releasesImprovements

Générateur de serveur MCP

Générez des serveurs MCP pour que les applications d’IA puissent interagir avec votre documentation ou vos API. Le contenu rédigé est automatiquement diffusé via un serveur MCP, et vous pouvez générer un serveur MCP à partir de votre spécification OpenAPI en un clic. Consultez la documentation pour démarrer avec MCP.

Améliorations

• Ajoutez des tags aux mises à jour du journal des modifications pour permettre aux utilisateurs finaux de filtrer
• Sonnet-3.7 pris en charge pour l’Assistant IA. Configurez votre modèle préféré depuis le tableau de bord
• Modifiez le nom de votre déploiement directement dans les paramètres du tableau de bord

Corrections de bugs

• Correction des images OG
• Correction d’une incohérence de style d’icône pour les ancres sans conteneur
• Ajustements de style de la bordure du tableau de bord pour une meilleure réactivité mobile/tablette/ordinateur
• Affichage des exemples de code même en mode simple dans le Bac à sable API
• Prise en charge du raccourci « command + k » pour la recherche dans l’éditeur web
• Les blocs de code dans les encadrés s’étendent pour occuper toute la largeur de la zone de l’encadré

​

February 2025

New releasesImprovements

Nouveau schéma de configuration docs.json

Nous avons introduit un nouveau schéma docs.json en remplacement de mint.json, afin de prendre en charge un versionnage multiniveau plus performant, une lecture visuelle plus aisée et une terminologie plus cohérente. Pour plus d’informations sur les modifications, consultez notre blog.

Mettez à niveau de mint.json vers docs.json en suivant ces étapes :

1. Assurez-vous que votre CLI est à jour

npm i mint@latest -g

1. Dans votre dépôt de documentation, exécutez

mint upgrade

1. Supprimez votre ancien fichier mint.json et poussez vos modifications

Vérifications CI

Analysez automatiquement vos docs pour trouver les liens brisés, détecter les problèmes d’orthographe et de grammaire, ou appliquer des styles rédactionnels avec votre propre configuration Vale. En savoir plus dans notre documentation.

Prise en charge de .md pour les LLM

Toutes les pages de documentation sont désormais automatiquement disponibles en fichiers Markdown simples — il suffit d’ajouter .md à l’URL. Cela facilite l’ingestion de pages individuelles de votre documentation par les LLM.

Plus de thèmes

Nouveaux thèmes prêts à l’emploi pour modifier l’apparence et l’ergonomie de vos docs. Configurez-les via votre fichier docs.json.

Disponibles dès maintenant :

• Maple
• Palm
• Willow

Autres améliorations

• Guide de rédaction technique : bonnes pratiques pour rédiger une documentation technique, incluant la recherche d’audience, les types de contenu et des conseils d’écriture.
• Composant Dropdown : Organisez la navigation avec un menu déroulant, en plus des onglets et des ancres.
• Correcteur de syntaxe IA : l’Éditeur web détectera les erreurs d’analyse et utilisera l’IA pour proposer des corrections.

​

January 2025

Improvements

Améliorations de l’Assistant IA

• Nouvelle interface avec page de chat dédiée et invites préremplies
• Améliorations de stabilité, p. ex. correction de bugs entraînant l’édition du mauvais fichier ou d’aucun fichier
• Connaissances plus robustes pour l’ajout et la modification de composants
• Amélioration de l’édition du fichier docs.json

Authentification partielle

Personnalisez l’accès à n’importe quelle page ou section de contenu en fonction des permissions utilisateur. Compatible avec votre propre système d’authentification.

Bac à sable API repensé

Nous avons refondu le design et les performances du Bac à sable API. Les mises à jour incluent :

• Dépliage des détails facilité pour une vue d’ensemble d’un champ
• Conception imbriquée plus intuitive, p. ex. ajout ou suppression d’éléments
• Temps de réponse plus rapides

Améliorations de qualité

• Prise en charge de l’exigence d’authentification pour accéder aux déploiements de prévisualisation

​

December 2024

Authentification

Rendez les docs privées en configurant l’authentification via JWT, OAuth ou un mot de passe universel. Avec ce niveau de confidentialité, vous pouvez créer une base de connaissances interne ou empêcher les concurrents de consulter vos docs.

​

November 2024

Rédacteur IA

Vous pouvez désormais demander à l’IA de modifier votre documentation en tenant compte du contexte de l’ensemble des contenus existants. Saisissez une instruction et le rédacteur proposera des changements en générant une pull request.

Amélioration de l’intégration GitLab

Nous avons amélioré la synchronisation avec GitLab, notamment en activant les mises à jour automatiques et les déploiements de prévisualisation. Consultez notre documentation sur GitLab pour commencer.

Éditeur web

Nous avons repensé notre éditeur web afin que vous puissiez désormais mettre à jour la documentation avec une expérience WYSIWYG complète, tout en restant synchronisé avec le Markdown.

Consultez notre documentation pour bien démarrer avec l’éditeur web.

Prise en charge de /llms.txt

Toutes les instances de documentation sont désormais automatiquement hébergées sur /llms.txt et /llms-full.txt afin que les LLM puissent ingérer votre documentation plus facilement. Pour en savoir plus, consultez la documentation sur le nouveau standard llms.txt.

Localisation

Vous pouvez désormais localiser votre documentation, de manière similaire à la gestion des versions. Ajoutez un locale à une version et le contenu fixe dans Mintlify, comme « Cette page vous a-t-elle été utile ? », s’alignera également sur la langue.

Améliorations de la qualité

• Retourner les résultats de chat et de recherche en fonction de la version que l’utilisateur est en train de consulter
• Authentifier les utilisateurs avec OAuth, en plus des jetons JWT ou Shared Session

​

Octobre 2024

Journal des modifications

Lancement d’un nouveau composant Update pour faciliter l’affichage et la communication des mises à jour (comme celle-ci) à vos utilisateurs.

Mise en évidence de lignes de code

Vous pouvez désormais mettre en évidence des lignes de code dans votre documentation pour attirer l’attention sur les parties importantes en ajoutant un commentaire spécial après l’identifiant de langage. Utilisez des accolades {} et indiquez des numéros de ligne ou des plages séparés par des virgules.

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();
```

Blocs de code en mode clair

Les blocs de code disposent désormais d’une variante en mode clair, activable en ajoutant ce qui suit à votre docs.json :

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

Pied de page avancé

Vous pouvez désormais ajouter davantage de liens au pied de page standard. Cette amélioration apporte plus de cohérence entre les pages d’accueil et la documentation, ou une personnalisation accrue si vous souhaitez mettre en avant des pages spécifiques comme les réseaux sociaux ou les journaux d’état.

Filtrer la recherche selon l’utilisateur actuel

Lorsque la personnalisation est activée, les résultats de recherche sont désormais filtrés en fonction de l’utilisateur connecté afin qu’il ne voie que le contenu pertinent.

Prompts personnalisés pour le chat IA

Vous pouvez désormais personnaliser les prompts du chat IA. Veuillez contacter le support si vous souhaitez personnaliser ces prompts.

Améliorations du tableau de bord

• Ajout de la possibilité de définir le domaine personnalisé sur /docs directement via les paramètres du tableau de bord.
• Fusion des pages de connexion et d’inscription afin de réduire les frictions et la confusion.
• Mise en place du parcours de connexion « discovery » afin que les utilisateurs membres de plusieurs organisations puissent désormais basculer entre elles.
• Ajout de la connexion via Google OAuth
• Ajout de la possibilité d’ajouter un nouveau déploiement via les paramètres du tableau de bord.

Corrections de bugs

• Il est désormais possible d’utiliser des barres obliques initiales dans la navigation.
• Il est désormais possible de modifier les fichiers CSS et JS dans l’Éditeur web.
• Correction de suggestEdit qui ne s’affichait pas même lorsqu’il était activé.
• Correction de la navigation au clavier pour la Recherche et le Chat, vous pouvez désormais utiliser les flèches haut et bas pour parcourir les résultats.
• Interdiction aux moteurs de recherche d’explorer les pages protégées par l’authentification utilisateur.
• Revalidation du cache lorsqu’une organisation est supprimée.
• Nous utilisons désormais l’analyseur OpenAPI Scalar pour analyser les définitions OpenAPI, ce qui améliore les performances, corrige les problèmes d’analyse et fournit de meilleurs messages d’erreur.
• Les descriptions de niveau supérieur sont désormais prises en charge dans les pages de référence API générées automatiquement à partir des définitions OpenAPI.
• Ajout de la prise en charge du style en ligne pour les icônes.
• Correction du pop-in du CSS personnalisé dans la documentation.
• Affichage correct du style de code en ligne conjointement avec les liens.
• Maintien de la position de défilement lorsque vous cliquez sur le bouton Retour du navigateur.

​

September 2024

Polices personnalisées

Personnalisez la typographie de vos docs avec votre propre police hébergée sur un CDN ou en choisissant parmi les Google Fonts pour aligner vos docs sur votre marque.

Images dans les composants Card

Ajoutez une propriété img à une carte pour afficher une image en haut de la carte. En savoir plus ici.

Améliorations des performances de mise à jour

Pour les projets volumineux (~3 000 fichiers), l’étape de téléchargement des mises à jour de docs est désormais ~440× plus rapide — soit une réduction de 99,8 % du temps. De manière générale, les téléchargements de fichiers lors des mises à jour sont maintenant ~5,5× plus rapides — une réduction de 81,8 %.

Améliorations SEO

Nous avons corrigé la mise en page mobile et desktop de nos docs afin qu’elles soient plus adaptées au SEO — notamment en ajoutant des balises ARIA appropriées à la barre de navigation et aux éléments de bascule.

Améliorations du tableau de bord

• Migration vers App Router dans le tableau de bord.
• Les analyses de recherche sont désormais disponibles dans le tableau de bord.
• Ajout d’une fonctionnalité de suppression d’organisation.
• Interface de connexion GitLab livrée.
• Correction de données d’analytics incorrectes.
• Les modules complémentaires peuvent désormais être achetés directement via le tableau de bord.

Corrections de bugs

• Correction d’un bug où la barre supérieure ne s’étirait pas à la largeur de l’écran lorsqu’elle est en mode personnalisé et que la mise en page de la barre latérale est sidenav.
• Correction du positionnement relatif du widget IA.

Plus

• Dépannage pour les pages API : les pages API peuvent être complexes, nous avons donc listé les problèmes courants pour vous aider à les résoudre rapidement — Lire la documentation

​

August 2024

Pages de référence OpenAPI

• Les endpoints définis par OpenAPI qui sont complexes et récursifs sont désormais 98 % plus compacts.
• Nous affichons maintenant additionalProperties dans les pages OpenAPI.

Téléversements de fichiers dans le Bac à sable API

Par défaut, les requêtes du Bac à sable API sont relayées via un proxy Mintlify. Vous pouvez désormais utiliser disableProxy pour désactiver ce comportement et prendre en charge des types de requêtes comme les téléversements de fichiers.

• En savoir plus sur les configurations API

Améliorations SEO mobile

Nous avons corrigé la mise en page mobile de nos docs afin qu’elles soient plus adaptées au SEO — notamment en ajoutant des balises ARIA appropriées aux éléments.

Formulaire d’assistance

Nous avons ajouté un formulaire d’assistance plus détaillé dans le tableau de bord Mintlify. Vous pouvez désormais soumettre un formulaire pour nous contacter.

Corrections de bugs

• Correction d’un bug lié à l’intégration Segment.
• Nous affichons à présent des messages d’erreur plus granulaires pour les autorisations GitHub lors des interactions avec l’éditeur.
• Correction de bugs où la navigation ne se déployait pas correctement lorsqu’un lien direct était utilisé.

​

July 2024

Widget IA

Pour les utilisateurs Pro, nous avons introduit Mintlify Widget, une extension de vos docs pour répondre aux questions de vos utilisateurs quand et où elles sont posées. Vous pouvez ajouter ce chatbot propulsé par l’IA à n’importe quelle page web : votre page d’accueil, dans votre produit ou sur vos pages de documentation existantes.

• Lire l’annonce sur le blog

Offre Pro

Nous avons également mis à jour nos offres tarifaires pour une meilleure personnalisation et une meilleure évolutivité.

• Lire l’annonce sur le blog

Synchronisation des exemples de code du Bac à sable API

Lorsque vous parcourez la documentation API, l’exemple de code sélectionné se synchronise désormais sur l’ensemble de vos pages.

Insights

Actuellement en bêta, cette fonctionnalité résume les questions et schémas courants des utilisateurs en rapports faciles à lire, avec des suggestions propulsées par l’IA pour améliorer votre produit.

​

June 2024

Temps forts de la Launch Week

• Thèmes : personnalisez le style avec des thèmes préconfigurés. Il suffit d’ajouter le thème Quill, Prism ou Venus à votre fichier docs.json et le style de votre documentation sera mis à jour.
• Search V2 : interrogez directement les descriptions et titres des endpoints OpenAPI pour accéder aux pages de référence API, excluez les Pages cachées des résultats de recherche et profitez de notre barre de recherche mise à jour.
• Branches dans l’Éditeur web : créez des branches dans notre Éditeur web sans IDE.
• Personnalisation utilisateur : authentifiez les utilisateurs avec Shared Session ou JWT afin d’afficher du contenu personnalisé, comme le préremplissage des clés API ou l’affichage de contenus spécifiques pour certains clients.
• Améliorations de l’automatisation OpenAPI : pour renseigner automatiquement les pages du Bac à sable API, vous pouvez ajouter un champ openapi à un objet dans les tableaux tabs ou anchors du docs.json.

​

May 2024

Okta SSO

Nous prenons désormais en charge la connexion via Okta SAML et OIDC.

API REST Mintlify

Déclenchez des mises à jour de votre documentation par programmation.

​

April 2024

Mode personnalisé

Ajoutez une configuration aux métadonnées pour supprimer tous les éléments à l’exception de la barre supérieure. Exemples d’usages :

• Créer une page d’accueil globale personnalisée avec des composants sur mesure
• Ajouter des vidéos plein écran ou des galeries d’images
• Intégrer des éléments de démo iFrame personnalisés pour ajouter de l’interactivité à votre documentation

Consultez notre documentation sur le mode personnalisé.

​

March 2024

Mintlify MDX pour VSCode

Insérez des extraits de nos composants et encadrés prédéfinis sans quitter VSCode. Installez l’extension ici.

​

February 2024

Améliorations de qualité

• Améliorations du tableau de bord : consultez les journaux de mise à jour pour voir ce qui a changé et l’état d’une mise à jour, basculez entre les projets Mintlify pour gérer les déploiements
• Versioning avec onglets entièrement pris en charge
• Redirections génériques (wildcard) désormais prises en charge
• Détection d’erreurs CLI : nous affichons désormais la position du frontmatter invalide lorsqu’il y a des problèmes d’analyse pendant le développement local

​

January 2024

Temps forts de la Launch Week

• Déploiements de prévisualisation : lorsque vous créez une pull request, nous générons un lien unique qui affiche un aperçu en direct de l’apparence de votre documentation en prod. Vous pouvez partager ce lien avec vos coéquipiers.
• Snippets V2 : nous prenons désormais en charge des composants et des variables entièrement réutilisables pour les snippets.
• Moteur MDX open source : nous avons exposé deux API — getCompiledMdx et MDXComponent — pour que vous puissiez accéder au markdown Mintlify et à la coloration syntaxique du code. Les contributions au projet sont les bienvenues.
• Insights d’IA Chat : segmentez l’historique des conversations par date, augmentez le quota d’IA Chat depuis le tableau de bord et voyez à quelle fréquence une requête spécifique apparaît.