À noter que cela était déjà fait chez Gitlab et que c'est fort loin d'être fait chez Atlassian et Gitea.
Et LinuxFr ? (on me souffle dans l'oreillette que ce n'est pas encore trolldi)
“It is seldom that liberty of any kind is lost all at once.” ― David Hume
Le/la vocabulaire/syntaxe du Modèle C4 est vachement plus complexe (i.e. plus élaboré/avancé, avec plus de paramètres, pas plus compliqué…) que celui des Graphes Mermaid je trouve.
Ceci dit, il y a beaucoup de choses communes mais juste avec une syntaxe différente ; sachant que les règles de syntaxe retenues sont communes à tous les types de diagrammes que fait Mermaid (ce qui est appréciable pour les usagers et probablement pour le développement aussi.) Fort de cela, il y a Structurizr qui propose un convertisseur mais on peut faire la même chose manuellement (comme une des premières réponses.) Dans les deux cas il y a une étape intermédiaire (la traduction entre deux langues en somme.)
“It is seldom that liberty of any kind is lost all at once.” ― David Hume
J'ai lu ceci ce matin, qui explique qu'il faut voir Structurizr comme un outil/langage métier (une mise en œuvre de la modélisation C4), là où il faut voir Mermaid-JS et PlantUML comme langages macros de dessin (macro au sens de plus haut niveau et avec plus de choses automatiques –surtout les placements, comme GraphViz— que les logiciels type Dia/yEd où on fait tout à la main en interface graphique…) https://www.augmentedmind.de/2020/12/20/plain-text-diagrams-as-code/
C'est pour ça que je trouvais Structurizr/C4 plus complexe car on décrit des modèles et non des dessins, et qu'il n'y a pas de correspondance directe (si Mermaid ou PlantUML part de cette syntaxe, ce sera une approximation sans pouvoir faire les vérifications de cohérence métier.) Mais c'est faisable (juste pas pertinent et on perdrait les éléments de cohérence de leurs syntaxes, mais c'est faisable.) J'ai lu un autre lien qui montre la différence des deux approches : le DSL connait la logique interne et sait générer des résultats différents, alors que l'approche dessins ne se préoccupe que de ce qu'on veut rendre et on doit gérer les autres aspects à côté ; le mieux étant enfin de générer le code Mermaid/Plant via Structurizr… https://dev.to/simonbrown/modelling-software-architecture-with-plantuml-56fc
“It is seldom that liberty of any kind is lost all at once.” ― David Hume
Je ne connaissais pas Mermaid. J'avais cherché un plugin pour faire du dot/graphviz pour Redmine, mais pour Mermaid çaexiste. Je vais pouvoir intégrer des petits graphs dans les tickets/wiki sans passer par un outil externe.
C'est, àmha, beaucoup moins puissant que Dot… Mais pour la grande majorité des graphes qu'on fait (on utilise à peine 10% des possibilités de Dot il me semble), Mermaid fait amplement l'affaire. (et les rares fois où j'ai eu besoin de plus, c'est que mon schéma était un peu trop compliqué.)
“It is seldom that liberty of any kind is lost all at once.” ― David Hume
# enfin ?
Posté par Gil Cot ✔ (site web personnel, Mastodon) . Évalué à 4.
La plateforme Github se gargarise du support de Mermaid.js comme syntaxe (sauf qu'au lieu de la coloration syntaxique, c'est le rendu du diagramme qui sera fait en utilisant cette bibliothèque https://github.com/mermaid-js/mermaid#readme )
À noter que cela était déjà fait chez Gitlab et que c'est fort loin d'être fait chez Atlassian et Gitea.
Et LinuxFr ? (on me souffle dans l'oreillette que ce n'est pas encore trolldi)
“It is seldom that liberty of any kind is lost all at once.” ― David Hume
[^] # Re: enfin ?
Posté par David Delassus (site web personnel) . Évalué à 2.
J'attend le support des modèles C4 dans mermaid pour m'en servir : https://github.com/mermaid-js/mermaid/issues/1276
https://link-society.com - https://kubirds.com - https://github.com/link-society/flowg
[^] # Re: enfin ?
Posté par Gil Cot ✔ (site web personnel, Mastodon) . Évalué à 2.
Le/la vocabulaire/syntaxe du Modèle C4 est vachement plus complexe (i.e. plus élaboré/avancé, avec plus de paramètres, pas plus compliqué…) que celui des Graphes Mermaid je trouve.
Ceci dit, il y a beaucoup de choses communes mais juste avec une syntaxe différente ; sachant que les règles de syntaxe retenues sont communes à tous les types de diagrammes que fait Mermaid (ce qui est appréciable pour les usagers et probablement pour le développement aussi.) Fort de cela, il y a Structurizr qui propose un convertisseur mais on peut faire la même chose manuellement (comme une des premières réponses.) Dans les deux cas il y a une étape intermédiaire (la traduction entre deux langues en somme.)
“It is seldom that liberty of any kind is lost all at once.” ― David Hume
[^] # Re: enfin ?
Posté par Gil Cot ✔ (site web personnel, Mastodon) . Évalué à 2.
J'ai lu ceci ce matin, qui explique qu'il faut voir Structurizr comme un outil/langage métier (une mise en œuvre de la modélisation C4), là où il faut voir Mermaid-JS et PlantUML comme langages macros de dessin (macro au sens de plus haut niveau et avec plus de choses automatiques –surtout les placements, comme GraphViz— que les logiciels type Dia/yEd où on fait tout à la main en interface graphique…) https://www.augmentedmind.de/2020/12/20/plain-text-diagrams-as-code/
C'est pour ça que je trouvais Structurizr/C4 plus complexe car on décrit des modèles et non des dessins, et qu'il n'y a pas de correspondance directe (si Mermaid ou PlantUML part de cette syntaxe, ce sera une approximation sans pouvoir faire les vérifications de cohérence métier.) Mais c'est faisable (juste pas pertinent et on perdrait les éléments de cohérence de leurs syntaxes, mais c'est faisable.) J'ai lu un autre lien qui montre la différence des deux approches : le DSL connait la logique interne et sait générer des résultats différents, alors que l'approche dessins ne se préoccupe que de ce qu'on veut rendre et on doit gérer les autres aspects à côté ; le mieux étant enfin de générer le code Mermaid/Plant via Structurizr…
https://dev.to/simonbrown/modelling-software-architecture-with-plantuml-56fc
“It is seldom that liberty of any kind is lost all at once.” ― David Hume
# Chouette
Posté par cg . Évalué à 3.
Je ne connaissais pas Mermaid. J'avais cherché un plugin pour faire du dot/graphviz pour Redmine, mais pour Mermaid ça existe. Je vais pouvoir intégrer des petits graphs dans les tickets/wiki sans passer par un outil externe.
Chouette, merci pour la découverte !
[^] # Re: Chouette
Posté par Gil Cot ✔ (site web personnel, Mastodon) . Évalué à 2.
C'est, àmha, beaucoup moins puissant que Dot… Mais pour la grande majorité des graphes qu'on fait (on utilise à peine 10% des possibilités de Dot il me semble), Mermaid fait amplement l'affaire. (et les rares fois où j'ai eu besoin de plus, c'est que mon schéma était un peu trop compliqué.)
“It is seldom that liberty of any kind is lost all at once.” ― David Hume
Suivre le flux des commentaires
Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.