Mintlify Workflows

À propos de Mintlify Workflows

Mintlify Workflows est une fonctionnalité d’automatisation de documentation, actuellement en version bêta, intégrée à la plateforme Mintlify. Elle permet d’exécuter des tâches agentiques sur un dépôt selon différents déclencheurs : poussée de code (push), calendrier personnalisé ou webhook associé aux demandes de tirage GitHub. Les modifications peuvent être proposées via une demande de tirage ou appliquées directement sur la branche de déploiement.

Cette solution vise principalement la maintenance de contenu documentaire. Elle prend en charge les traductions, la détection de liens brisés, l’optimisation pour les moteurs de recherche, la correction grammaticale, l’harmonisation du ton selon la marque, la génération de journaux des modifications et la synchronisation entre le contenu et le code source.

Mintlify Workflows s’intègre de manière native à l’écosystème Mintlify, ce qui garantit une cohérence avec le cycle de publication existant. La plateforme héberge la logique sous-jacente des workflows préconfigurés et peut l’améliorer au fil des versions, réduisant ainsi la charge de maintenance manuelle pour les équipes.

Fonctionnalités principales

Workflows préconfigurés. Mintlify propose des processus prêts à l’emploi pour : mettre à jour le contenu à partir du code, générer un journal des modifications, assurer les traductions, vérifier les liens brisés, auditer le référencement naturel, corriger la grammaire et harmoniser le ton selon la marque. L’activation peut se faire en deux clics.

Workflows personnalisés. Les organisations peuvent définir leurs propres processus en précisant une consigne, un déclencheur, des instructions optionnelles, des dépôts de contexte et le mode de mise à jour souhaité.

Déclencheurs supportés. Trois types de déclencheurs sont disponibles : sur poussée ou modification de contenu, sur changement de code, ou selon un calendrier personnalisé.

Contexte multi-dépôts. Chaque workflow peut référencer jusqu’à dix dépôts de contexte, ce qui permet d’enrichir la documentation avec des informations provenant de plusieurs sources.

Intégrations avec des agents externes. La solution peut se connecter à des outils comme Slack, Notion ou Linear pour fournir un contexte supplémentaire lors de l’exécution d’un workflow.

Mode de livraison. Les modifications peuvent être proposées via une demande de tirage, avec fusion automatique possible, ou appliquées directement sur la branche de déploiement.

Gestion centralisée. L’activation, la désactivation, le déclenchement manuel et la suppression des workflows s’effectuent depuis le tableau de bord Mintlify ou par l’interface en ligne de commande.

Limites d’utilisation. La version actuelle permet jusqu’à dix workflows actifs par organisation et vingt exécutions par jour par workflow. Les exécutions échouées ne sont pas comptabilisées.

Tarification

La tarification de Mintlify Workflows n’est pas entièrement publique et varie selon l’état de la version bêta et les plans proposés. Voici les éléments disponibles à partir des sources consultées.

Plan requis. Selon la documentation la plus récente, les workflows sont réservés au plan Entreprise. Pour activer la fonctionnalité pour une organisation, il faut contacter Mintlify afin d’obtenir un devis personnalisé.

Phase bêta. Une documentation traduite en chinois indique que tous les plans bénéficient actuellement de la gratuité pendant la phase bêta, mais précise que les fonctionnalités, la disponibilité et la tarification peuvent changer. Ces deux sources suggèrent une évolution du modèle : la version la plus récente et la plus directement liée aux workflows indique une restriction au plan Entreprise, tandis que la traduction chinoise semble refléter un état antérieur ou transitoire de la bêta.

Tarification à l’usage. Une documentation en espagnol mentionne que chaque exécution consomme des crédits. Un workflow de mise à jour à partir de changements de code coûte généralement entre 40 et 180 crédits selon la complexité de la tâche.

Prérequis Git. Pour les utilisateurs de GitLab, les workflows nécessitent un niveau payant de GitLab, car Mintlify utilise des jetons d’accès de projet à durée limitée, non pris en charge par GitLab gratuit.

Recommandation. En l’absence d’une grille tarifaire publique, il est conseillé de contacter directement Mintlify pour obtenir un devis adapté à votre volume d’exécution et à votre plan d’abonnement.

Cas d’utilisation

Mintlify Workflows répond à plusieurs besoins récurrents dans les équipes de documentation et de développement.

Synchronisation documentation-code. Après la fusion d’une demande de tirage, un workflow peut mettre à jour automatiquement la documentation pour refléter les changements de code.

Génération de journaux des modifications. Sur une base récurrente, un workflow peut produire et publier un journal des modifications à partir des commits et des libérations.

Maintenance des traductions. Les workflows peuvent détecter les écarts entre les versions linguistiques d’une documentation et proposer des mises à jour.

Détection et correction de liens brisés. Un processus automatisé peut parcourir les pages de documentation et identifier les liens qui ne fonctionnent plus.

Audit de référencement naturel. Les workflows peuvent vérifier les balises, les titres et la structure des pages pour s’assurer qu’ils respectent les bonnes pratiques de référencement.

Correction linguistique et harmonisation du ton. La solution peut analyser le contenu pour détecter les erreurs de grammaire, d’orthographe et les incohérences de ton par rapport à la charte éditoriale.

Mise à jour des références techniques. Lorsque le code évolue, un workflow peut ajuster les descriptions d’API, les exemples de code et les instructions techniques.

Notre avis

Mintlify Workflows se distingue par sa simplicité de configuration pour les tâches documentaires courantes. Les workflows préconstruits réduisent considérablement l’effort d’intégration, ce qui permet aux équipes de déployer des processus automatisés en quelques instants. La flexibilité offerte par les workflows personnalisés, le contexte multi-dépôts et les intégrations externes en fait un outil adapté aux besoins spécifiques des organisations.

Cependant, certains aspects limitent son attrait à grande échelle. La restriction actuelle au plan Entreprise exclut les petites équipes et les startups qui utilisent des formules moins coûteuses. L’absence de grille tarifaire publique rend difficile l’évaluation du budget nécessaire, d’autant plus que la tarification à l’usage par crédits peut varier considérablement selon la complexité des workflows. Les limites de dix workflows actifs et de vingt exécutions par jour par workflow peuvent également contraindre les organisations qui ont une volumétrie élevée de contenu.

La dépendance à l’écosystème Git et aux connecteurs supportés constitue une autre contrainte. Les utilisateurs de GitLab, par exemple, doivent souscrire un plan payant pour pouvoir utiliser les workflows. Enfin, l’outil reste centré sur la documentation et n’est pas conçu comme une solution d’automatisation généraliste.

Mintlify Workflows est particulièrement recommandé pour les équipes de documentation, les relations avec les développeurs, les équipes produit et d’ingénierie de plateforme qui utilisent déjà Mintlify et qui cherchent à automatiser les tâches répétitives de maintenance documentaire. Il convient aussi aux organisations qui gèrent une documentation volumineuse ou multilingue et qui disposent d’un processus Git mature.

Pour les équipes qui recherchent une solution plus flexible ou qui ne souhaitent pas migrer vers Mintlify, des alternatives comme GitHub Actions ou GitLab CI offrent une automatisation générale, mais nécessitent de construire soi-même la logique documentaire. Des solutions no-code comme Make ou Zapier peuvent relier des outils, mais sont moins adaptées à l’édition de documentation dans un dépôt Git.