Mises à jour du produit

Nouvelles versions et améliorations

​

20 septembre - 26 septembre

Improvements

​

Extension de la prise en charge des langues

• Ajout de la prise en charge du roumain et du tchèque dans l’interface de documentation
• Capacités de localisation étendues avec une couverture de traduction complète pour les nouvelles langues
• Amélioration du sélecteur de langue sur tous les thèmes

​

Améliorations de l’UI et de l’expérience utilisateur

• Correction des problèmes de visibilité des onglets sur les pages 404 pour éviter une mise en évidence incorrecte de l’onglet actif
• Amélioration de la gestion des images avec passage correct des attributs width et height pour les images non optimisées
• Mise en page et cohérence du style de la page 404 améliorées

​

Améliorations de l’infrastructure et des performances

• Amélioration du traitement des images GIF en évitant le formatage automatique Imgix coûteux afin de réduire le temps de traitement et l’utilisation de la bande passante
• Optimisation de la diffusion des images avec une gestion spécifique du contenu animé

​

Corrections de bugs et fiabilité

• Correction du routage des e‑mails de contact dans les paramètres du Dashboard pour les demandes d’add-on Assistant
• Amélioration des mises à jour du schéma de base de données pour une meilleure gestion des utilisateurs

​

14 septembre - 19 septembre

Improvements

​

Améliorations de l’intégration GitLab

• Amélioration de l’UI de connexion à GitLab dans les paramètres du Dashboard pour faciliter la gestion des référentiels
• Ajout de la prise en charge des webhooks pour les mises à jour automatiques de la documentation lors des commits GitLab

​

Éditeur web et améliorations de l’authentification

• Poursuite de la migration de l’app router pour l’éditeur web, suppression des blocages et amélioration des performances
• Amélioration de la gestion des erreurs de connexion avec des messages explicites de validation d’e‑mail
• Correction de la gestion des espaces dans la validation des adresses e‑mail

​

Corrections de bugs et fiabilité

• Correction de la mise à jour du socket de l’app router pour les fonctionnalités en temps réel
• Correction des problèmes de rendu des tracés SVG dans la documentation
• Correction de la navigation au clavier dans la recherche et le chat
• Amélioration de la fiabilité de l’endpoint d’état de l’historique
• Résolution de cas limites de middleware et de problèmes de gestion de l’événement onClick

​

31 août - 13 septembre

New releasesImprovements

​

Versions majeures

• Amélioration majeure : pages suggérées par l’IA sur les pages 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 pour l’Assistant peut désormais inclure des sources externes
  Remarque : Contactez-nous pour activer cette fonctionnalité pour votre site.

​

Assistant et MCP

• Correction d’un bug où l’Assistant était limité à tort par le taux de requêtes car la fenêtre temporelle ne défilait pas correctement
• Correction d’un bug dans l’appel d’outils de l’Assistant pour 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 height plusieurs fois supérieure à la zone d’affichage et défilait indéfiniment
• Correction d’un bug où les valeurs de dépenses de l’Assistant pouvaient s’afficher avec plus de deux décimales dans le Dashboard

​

Éditeur web et déploiements

• Renforcement de la sécurité de l’éditeur afin que seuls les utilisateurs disposant des write permissions sur le référentiel Git connecté puissent apporter des modifications
• Correction d’un bug où les aperçus de déploiement ne fonctionnaient pas pour les branches dont le nom contient =
• Correction d’un bug où les noms de branche longs débordaient des modales lors de la création d’aperçus de déploiement
• Amélioration de confort : le paramètre de requête e‑mail 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 d’API et navigation

• Plusieurs codes de réponse du bac à sable d’API s’affichent désormais dans un menu select stylisé contrôlé au lieu du menu select système 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 UI

• 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 pour 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 après rejet de la bannière de notification
• Amélioration des thèmes Maple et Willow avec l’ajout de boutons de connexion/déconnexion dans la barre latérale pour un accès plus facile

​

Analytics et exports

• Correction des problèmes de fiabilité de la vue Analytics de l’Assistant et des exports
• Les exports Analytics de l’Assistant sont désormais exécutés en arrière‑plan et envoyés par e‑mail pour une expérience plus fiable

​

August 24 - August 30

Improvements

​

Publication majeure : collecte de retours améliorée

• Amélioration majeure : Les lecteurs peuvent désormais donner un avis plus détaillé après avoir sélectionné pouce levé/baissé, avec des options et des commentaires écrits. Vous pouvez aussi collecter des retours sur les code blocks et consulter toutes les réponses dans les Analytics de votre Dashboard.
  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 en soucier dans votre docs.json
• Vous pouvez désormais ajouter l’attribut noAnchor à vos balises HTML h1-6 pour éviter la création d’un lien d’ancre
• Le thème Palm propose désormais un sélecteur de langue flottant en bas à gauche, similaire à l’approche de Stripe
• Ajout d’un nouveau champ dans docs.json, appelé drilldown, qui vous permet de contrôler si les utilisateurs sont dirigés ou non vers la première page d’un groupe de navigation lorsque le groupe est développé
• Amélioration de confort pour alterner les styles des listes ordonnées imbriquées entre décimal/Romain et alphabétique

​

Correctifs et fiabilité

• Correction d’un bug où les liens d’ancrage de position de défilement ne fonctionnaient pas correctement en présence de composants JS sur une page
• Correction d’un bug où Google indexait des fichiers *.md bruts faute d’un en‑tête x-robots-tag noindex
• Correction d’un bug avec OAuth sur les docs protégées où vous n’étiez pas redirigé vers votre page initiale une fois le parcours terminé avec succès
• Correction d’un bug sur les aperçus des docs protégées par authentification où la barre de navigation complète n’était pas visible
• Correctifs 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 d’API définies en MDX et sécurisées garantiront une stabilité accrue

​

Améliorations des performances

• Amélioration des performances en déplaçant le CSS de 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 référentiel (PDF, TXT, XML, etc.) sont désormais automatiquement téléversés et servis lors du déploiement, pour 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 un véritable é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

• Nouvelle prise en charge de l’authentification sur des sous‑répertoires personnalisés : si vous servez la documentation à https://yourdomain.com/docs, l’authentification fonctionne désormais sans friction
• Correction d’un bug d’affichage de la barre latérale qui apparaissait à tort 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

​

Correctifs de composants et de style

• Résolution d’un problème de conversion des balises <h1-6> qui les transformait à tort en composants Heading et perturbait les styles personnalisés
• Bascule de configuration de l’Assistant en un clic ajoutée au Dashboard pour une gestion simplifiée

​

Améliorations techniques et fiabilité

• Système de journalisation amélioré pour les flux de mise à jour, permettant un débogage plus rapide et une résolution accélérée des problèmes
• Correction de la limitation de taux 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 référentiel
• Fiabilité de l’Assistant améliorée grâce à une prise en charge de LLM de secours, une meilleure gestion des erreurs de limitation de taux et un outil de recherche plus robuste

​

10 août - 16 août

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 Next.js non mis en cache, ce qui améliore le time to first byte des pages non mises en cache.
• Le hachage basé sur le contenu évite la re‑transpilation lorsque le MDX n’a pas changé, réduisant d’environ 50 % les temps de mise à jour pour les clients avec un grand nombre de pages (les déploiements de plus de 5 minutes devraient être à peu près divisés par deux).
• L’affichage des déploiements de prévisualisation dans le Dashboard 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 instantanés plus fréquents.

​

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

• La conversion d’OpenAPI vers MCP a été déplacée vers le backend, permettant aux serveurs MCP hébergés d’inclure des outils (documentation et options de configuration plus claires à venir).
• Ajout de la prise en charge de Ruby dans le bac à sable d’API.
• Nous avons ajouté une fonctionnalité qui permet désormais de spécifier des pages d’API uniquement via 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 références 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 prévue.
• Encodage correct en URL des titres de branche contenant / pour éviter les ruptures de navigation.
• Correction du raccourci de création de lien Ctrl+K dans l’éditeur du Dashboard du monorepo, qui préfixait le chemin du dépôt de docs et créait des liens brisés.

​

Analytics 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 des LLM.
• Ajout de l’intégration Analytics Hightouch.
• Amélioration du suivi Analytics du menu contextuel (affichage dans le Dashboard à venir).
• Ajout de tests e2e pour llms.txt et llms-full.txt afin de garantir une diffusion correcte.

​

Améliorations des composants et du style

• Prise en charge des classnames personnalisés dans les balises h{1-4} pour appliquer des styles de titres personnalisés.
• Correction des balises h{1-4} rendues en tant que composants Heading avec des chips en mode page personnalisée.
• Ajout de sélecteurs CSS au fil d’Ariane (breadcrumbs) pour un ciblage CSS personnalisé.
• Correction des images Open Graph étirées en analysant les dimensions pour maintenir les proportions à une height de 56px.
• Correction de VSCode en VS Code dans le menu contextuel lorsqu’il est activé.
• Correction de l’apparition des titres au sein de composants personnalisés dans la table des matières aux côtés des titres sémantiques.

​

Corrections de bugs et fiabilité

• Correction de problèmes de rendu PDF avec certains titres de page en assainissant les caractères causant des problèmes de génération.
• Résolution de l’erreur de l’interface en ligne de commande (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 de la 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 des groupes : rendez des groupes de pages entiers publics via docs.json pour éviter d’avoir public: true sur 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 que vous avez spécifié pour relancer le flux d’authentification
• Correction d’un flash d’erreur 500 pendant les flux OAuth/JWT avant le callback
• Suppression automatique de https:// des URL dans la configuration d’auth OAuth/JWT pour éviter les erreurs de configuration

​

Améliorations du bac à sable d’API

• Nouveau endpoint Search API pour vous permettre de créer des agents et des serveurs MCP par-dessus votre documentation
• Les fichiers openapi et asyncapi sont désormais servis à leurs chemins spécifiés (par exemple, https://mydocsurl.extension/{openapi-or-file-name}.json)
• Vous pouvez désormais utiliser le x-mint field in your openapi files pour remplacer des champs générés, personnaliser le contenu d’introduction ou modifier les URL des endpoints 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’action (avec des 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 publication des serveurs MCP hébergés la semaine dernière

​

Performance et fiabilité

• Tous les fichiers image et vidéo présents dans votre dépôt de documentation sont désormais servis au chemin approprié sur votre domaine. Par exemple, si vous avez /assets/marketing/my-logo.png dans votre dépôt, il sera disponible à https://mydocsurl.extension/assets/marketing/my-logo.png.
• Le champ e-mail sur l’écran de connexion du Tableau de bord Mintlify se focalise désormais automatiquement pour que vous puissiez commencer à taper immédiatement (amélioration du confort)
• Indexation des domaines personnalisés et des sous-domaines dans Redis pour améliorer les temps de chargement de la navigation (réduction de latence d’environ 50 ms)
• Ajout d’une logique de nouvelle tentative pour les exports PDF afin d’améliorer la fiabilité
• Correction de la réapparition de la bannière de consentement aux cookies après acceptation ou fermeture — 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 l’Interface en ligne de commande (CLI) pour Windows et pnpm, plus des tests CI pour prévenir les régressions
• Amélioration de la sortie des logs d’erreur — 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 d’aperçu protégé par authentification de la semaine dernière où l’onglet actif n’était pas correctement défini dans l’interface de navigation
• Correction de la couleur d’arrière-plan du thème light qui ne s’appliquait pas aux icônes de l’onglet actif
• Correction d’un problème où la modification du type d’auth dans le Tableau de bord mettait à jour puis revenait au type précédemment enregistré — la nouvelle sélection persiste désormais après l’enregistrement
• Améliorations internes de l’DX pour les clients entreprise avec des bibliothèques UI personnalisées — il nous est désormais plus facile d’inclure vos composants et de répondre aux 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’authentification, permettant d’accélérer le développement des fonctionnalités et la correction de bugs dans cette partie du produit
• Les déploiements de prévisualisation sont désormais disponibles pour les sites protégés par authentification
• 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, cela ne fonctionnait que pour l’authentification partielle)

​

Améliorations du bac à sable d’API

• Correction du téléversement de fichiers multipart/form-data dans le bac à sable d’API
• Correction du comportement des liens d’ancrage pour que le clic mette à jour l’URL sans remonter en haut de 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 Copier aux réponses de chat
• Correction d’un problème lors de la nouvelle tentative d’envoi de messages dans l’Assistant
• Amélioration de l’invite par défaut de l’Assistant pour la rendre moins verbeuse

​

Performances et fiabilité

• Recherche plus réactive et précise en annulant les requêtes différées pendant la saisie
• Provisionnement de ressources pour un nouveau CDN – les temps de chargement des images et des pages devraient bientôt s’améliorer
• Correction de bugs lors du rendu de diagrammes Mermaid complexes comme les diagrammes de GANTT
• Correction de bugs de la 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 NextJS 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’éditeur web
• Correction des balises meta dupliquées pour OpenGraph
• Mise à niveau de MongoDB de la version 6 à 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-la directement depuis votre Tableau de bord Mintlify en quelques secondes
• Réponses contextuelles : recherche dans l’ensemble de votre documentation pour fournir des réponses pertinentes et exactes
• 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 intégrer des outils d’IA comme Claude, Cursor et 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 code blocks

• Surlignage syntaxique amélioré
• Ajout de davantage d’options de personnalisation, notamment le mode focus, les code blocks extensibles, l’adaptation aux modes sombre et light, 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 pour que les utilisateurs puissent aller directement à la source des réponses
• Raccourci pour copier les exemples de code générés par l’Assistant
• Raccourci “Ask AI” sur les code blocks dans la documentation pour générer des explications depuis l’Assistant

En savoir plus dans la documentation de l’Assistant.

​

Journaux des modifications abonnables

• Génère automatiquement un flux RSS à partir des pages du journal des modifications
• Intégrez les 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 d’API

• Rechercher pour trouver un endpoint
• Indiquer un endpoint obsolète avec une balise
• Masquer les pages d’API générées automatiquement dans la navigation
• Téléverser des fichiers multipart ou des données de formulaire

En savoir plus dans la documentation du bac à sable d’API

​

mint update

Vous pouvez désormais utiliser mint update pour mettre à jour votre Interface en ligne de commande (CLI).

​

Avril 2025

New releasesImprovements

​

Éditeur web 3.0

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

Améliorations majeures

• Rechercher des noms de 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 metadata pour le SEO
• Barre d’outils flottante lors de la sélection de texte

Correctifs supplémentaires

• Correction de la marge supérieure des composants du 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 renvoyé vers un état vide
• Couleurs des icônes de fichier uniformisé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 des citations en bloc qui 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 au format PDF.

​

Prise en charge des hooks React

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

​

Mars 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 exposé en tant que serveur MCP, et vous pouvez générer un serveur MCP à partir de votre spécification OpenAPI en un clic. Consultez la documentation pour commencer avec le MCP.

​

Améliorations

• Étiquetez les mises à jour du journal des modifications afin que les utilisateurs finaux puissent les filtrer
• Sonnet‑3.7 pris en charge pour l’IA Chat. Configurez votre modèle préféré via le Dashboard
• Modifiez le nom de votre déploiement directement dans les paramètres du Dashboard

​

Corrections de bugs

• Images OG corrigées
• Correction de l’incohérence de style des icônes pour les ancres sans conteneur
• Petits ajustements de style pour la bordure du Dashboard afin d’améliorer la réactivité mobile/tablette/desktop
• Affichage des exemples de code même en mode simple pour le bac à sable d’API
• Prise en charge du raccourci “command + k” pour la recherche dans l’éditeur web
• Les blocs de code dans les encarts s’étendent pour occuper toute la largeur de la zone

​

February 2025

New releasesImprovements

​

Nouveau schéma de configuration docs.json

Nous avons introduit un nouveau schéma docs.json pour remplacer mint.json, afin de prendre en charge un versionnage multiniveau amélioré, une lecture visuelle plus aisée et une terminologie plus cohérente. Pour en savoir plus sur les changements, consultez notre blog.

Mettez à niveau mint.json vers docs.json en suivant les étapes ci-dessous :

1. Assurez-vous que votre Interface en ligne de commande (CLI) est à jour

npm i mint@latest -g

1. Dans votre référentiel 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 nos docs.

​

Prise en charge de .md pour les LLM

Toutes les pages de documentation sont désormais automatiquement disponibles en tant que fichiers Markdown en clair — 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édéfinis pour modifier l’apparence et l’ergonomie de vos docs. Configurez-les via votre fichier docs.json.

Désormais disponibles :

• Maple
• Palm
• Willow

​

Autres améliorations

• Guide de rédaction technique : bonnes pratiques pour rédiger une documentation technique, dont l’étude de l’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étecte les erreurs d’analyse et utilise l’IA pour suggérer des correctifs.

​

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é, par exemple correction de bugs éditant le mauvais fichier ou aucun fichier
• Connaissances plus robustes pour l’ajout et l’édition 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 selon les autorisations des utilisateurs. Prend en charge la connexion à votre propre système d’authentification.

​

Bac à sable d’API repensé

Nous avons remanié la conception et les performances du bac à sable d’API. Les mises à jour incluent :

• Développement des détails plus simple pour obtenir un aperçu d’un champ
• Conception imbriquée plus intuitive, par exemple pour ajouter ou supprimer des é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 (JSON Web Token), OAuth ou un mot de passe universel. Grâce à cette confidentialité, vous pouvez créer une base de connaissances interne ou empêcher des concurrents de consulter vos docs.

​

November 2024

​

Rédacteur IA

Vous pouvez désormais demander à l’IA d’apporter des modifications à vos docs, en tenant compte du contexte de toute la documentation existante. Saisissez une requête et le rédacteur proposera des changements en générant un pull request (demande de fusion).

​

Mise à niveau de l’intégration GitLab

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

​

Éditeur web

Nous avons remanié notre éditeur web afin que vous puissiez désormais mettre à jour vos docs avec une expérience entièrement WYSIWYG (What You See Is What You Get), 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 docs sont désormais automatiquement accessibles à /llms.txt et /llms-full.txt pour que les LLM puissent ingérer facilement votre documentation. Pour en savoir plus, consultez la documentation sur le nouveau standard llms.txt.

​

Localisation

Vous pouvez désormais localiser vos docs, d’une manière similaire au versionnage. Ajoutez un locale à une version et le contenu fixe dans Mintlify, comme « Cette page vous a-t‑elle été utile ? », correspondra également à cette locale.

​

Améliorations de qualité

• Renvoyer les résultats du chat et de la recherche en fonction de la version que l’utilisateur est en train de lire
• Authentifier les utilisateurs avec OAuth, en plus de JWT (JSON Web Token) ou des jetons de session partagée.

​

October 2024

​

Journal des modifications

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

​

Surlignage de lignes de code

Vous pouvez désormais surligner des lignes de code dans votre documentation pour mettre en avant des parties importantes en ajoutant un commentaire spécial après l’identifiant du 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, qui peut être activée 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 offre plus de cohérence entre les pages d’accueil et la documentation, ou une plus grande personnalisation si vous souhaitez mettre en avant des pages spécifiques comme les réseaux sociaux ou les journaux d’état.

​

Filtrer la recherche en fonction de 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.

​

Invites personnalisées pour le chat IA

Vous pouvez désormais personnaliser les invites pour le chat IA. Veuillez contacter le support si vous souhaitez personnaliser les invites.

​

Améliorations du Dashboard

• Possibilité de définir le domain personnalisé sur /docs directement via les paramètres du Dashboard.
• Regroupement des pages de connexion et d’inscription pour réduire la friction et la confusion.
• Mise en place d’un flux de connexion « discovery » pour que les utilisateurs membres de plusieurs organisations puissent désormais basculer entre elles.
• Ajout de la connexion avec Google OAuth.
• Possibilité d’ajouter un nouveau déploiement via les paramètres du Dashboard.

​

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 Search et Chat afin que vous puissiez 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 authentification utilisateur.
• Revalidation du cache lors de la suppression d’une organisation.
• Nous utilisons désormais l’analyseur Scalar OpenAPI pour traiter les définitions OpenAPI, ce qui améliore les performances, corrige des 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 icons
• Correction du pop-in du CSS personnalisé dans la documentation.
• Affichage correct du style de code en ligne conjointement avec les liens.
• Conservation de la position de défilement lorsque vous cliquez sur le bouton Retour du navigateur.

​

September 2024

​

Polices personnalisées

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

​

Images dans les composants Card

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

​

Améliorations des performances de mise à jour

Pour les grands projets (~3 000 fichiers), l’étape de téléchargement des mises à jour de la documentation 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 désormais ~5,5× plus rapides — soit une réduction de 81,8 % du temps.

​

Améliorations SEO

Nous avons corrigé la mise en page mobile et desktop de notre documentation afin qu’elle soit plus favorable au SEO — notamment en ajoutant des balises aria adéquates à la barre de navigation et aux éléments de bascule.

​

Améliorations du Dashboard

• Migration vers App Router dans le Dashboard.
• Les Analytics de recherche sont désormais disponibles dans le Dashboard.
• La fonctionnalité de suppression d’une organisation a été ajoutée au Dashboard.
• Interface de connexion GitLab livrée.
• Correction de données Analytics incorrectes.
• Les add-ons peuvent désormais être achetés directement via le Dashboard.

​

Corrections de bugs

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

​

Plus

• Dépannage pour les pages d’API : les pages d’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 petits.
• Nous affichons désormais additionalProperties dans les pages OpenAPI.

​

Téléversements de fichiers dans le bac à sable d’API

Par défaut, les requêtes du bac à sable d’API sont relayées par Mintlify. Vous pouvez maintenant utiliser disableProxy pour désactiver ce comportement et prendre en charge des types de requêtes comme le téléversement de fichiers.

• En savoir plus sur les configurations d’API

​

Améliorations SEO sur mobile

Nous avons corrigé la mise en page mobile de notre documentation afin qu’elle soit plus favorable au SEO — notamment en ajoutant des balises aria adéquates aux éléments.

​

Formulaire d’assistance

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

​

Corrections de bugs

• Correction d’un bug affectant l’intégration Segment.
• Nous fournissons désormais des messages d’erreur plus granulaires pour les autorisations GitHub lors de l’utilisation de l’éditeur.
• Correction de bugs où la navigation ne se déployait pas correctement lorsqu’un lien direct était utilisé.

​

July 2024

​

Widget d’IA

Pour les utilisateurs Pro, nous avons lancé Mintlify Widget, une extension de votre documentation 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 mise à l’échelle facilitée.

• Lire l’annonce sur le blog

​

Synchronisation des exemples de code du bac à sable d’API

Lorsque vous parcourez la documentation d’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 d’utilisation les plus fréquents en rapports faciles à assimiler, avec des suggestions basées sur l’IA pour améliorer votre produit.

​

June 2024

​

Temps forts de la Launch Week

• Thèmes : personnalisez le style de vos docs 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 d’API, excluez les pages masquées de la 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 un JWT (JSON Web Token) afin de leur afficher du contenu personnalisé, comme le préremplissage de clés d’API ou l’affichage de contenu spécifique pour certains clients.
• Améliorations de l’automatisation OpenAPI : pour préremplir automatiquement les pages du bac à sable d’API, vous pouvez ajouter un champ openapi à un objet dans les tableaux tabs ou anchors dans le docs.json.

​

May 2024

​

Okta SSO

Nous prenons désormais en charge l’authentification 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 au metadata pour supprimer tous les éléments sauf la barre supérieure. Exemples d’utilisation :

• Créez une page d’accueil globale personnalisée avec des composants sur mesure
• Ajoutez des vidéos plein écran ou des galeries d’images
• Intégrez 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 la qualité

• Améliorations du Dashboard : 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 wildcard désormais prises en charge
• Détection d’erreurs de l’interface en ligne de commande (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 (demande de fusion), nous générons un lien unique qui affiche un aperçu en direct de l’apparence de votre documentation en production. Vous pouvez partager ce lien avec vos coéquipiers.
• Snippets V2 : nous prenons désormais en charge des composants et 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 de chat IA : segmentez l’historique de chat par date, augmentez le quota du Chat IA depuis le Dashboard et voyez à quelle fréquence une requête spécifique apparaît.