Les diagrammes d'architecture peuvent être des outils utiles pour documenter et communiquer la conception d'un système. Ils doivent être autodescriptifs, cohérents, suffisamment précis et liés au code. L'application de certaines directives peut garantir que les diagrammes sont utiles à diverses parties prenantes.
Le langage de description architecturale (e.g. UML, ArchiMate, etc.) fait-il une différence ?
Il y a beaucoup d'avis sur la question de savoir quel est le bon langage de description à adopter dans le projet. Certaines personnes pourraient faire valoir que l'UML est rigide et pas assez flexible pour modéliser la conception architecturale, un point de vue auquel je souscris. Néanmoins, dans certains cas, il peut être plus que suffisant pour documenter les principes fondamentaux d'une architecture sans s'appuyer sur des caractéristiques d'extensibilité de l'UML comme les profils et les stéréotypes. En examinant d'autres langages de description, nous pouvons constater que ArchiMate est plus puissant et plus adapté à la modélisation des systèmes d'entreprise par rapport à UML ; il existe également BPMN qui est particulièrement ciblé sur les processus d'entreprise, etc. Les comparaisons pourraient se poursuivre, mais je n'ai pas l'intention de les passer en revue de manière approfondie, car ce n'est pas le but de cet article.