Les Gantt Mermaid sont utiles quand un plan vit dans le même dépôt que les notes d’implémentation. La source textuelle est versionnée et relisible, ce qui convient aux releases, migrations et projets documentaires limités.
Définir dates et ID explicitement
gantt
title Publication de la documentation
dateFormat YYYY-MM-DD
axisFormat %b %d
section Recherche
Auditer les pages :done, audit, 2026-07-11, 3d
Choisir les sujets :topics, after audit, 2d
section Livraison
Rédiger les guides :active, draft, after topics, 6d
Revue technique :review, after draft, 2d
Publier :milestone, publish, after review, 0d
Les ID comme audit et draft sont des cibles stables pour after. Les libellés peuvent changer sans casser les dépendances. Définissez dateFormat avant les dates littérales.
Utiliser les marqueurs avec mesure
done, active, crit et milestone mettent l’état en évidence ; si tout est critique, le signal disparaît. Un jalon n’a pas de durée : c’est une décision ou un point de livraison.
Considérer les dépendances comme une communication
after draft exprime une dépendance fin-début. La planification réelle doit parfois gérer capacité, calendrier et avancement partiel. Mermaid n’est pas un moteur de gestion de projet complet ; pour les engagements contractuels, gardez le système officiel comme référence.
Garder le plan relisible
Regroupez les tâches, utilisez des libellés courts et mettez les dates à jour avec l’engagement concerné. Si le graphique dépasse un écran, séparez une roadmap des détails de la phase actuelle.
Ouvrez le modèle Gantt dans l’éditeur Mermaid local pour valider et exporter SVG ou PNG.