Une carte des types de diagrammes

Chaque type de diagramme résout un problème de communication différent. Utiliser le mauvais type pour votre contenu crée de la confusion : pas de la clarté. La première décision de conception est toujours : quel type d'informations suis-je en train de communiquer?

Les diagrammes structurels montrent ce qui existe & comment c'est connecté:

- Les diagrammes d'entités: nœuds & relations (schémas de base de données, organigrammes, graphes de connaissances) - Les diagrammes d'architecture: composants du système & leurs connexions (topologies réseau, systèmes logiciels) - Les diagrammes arborescents: hiérarchies (arbres de classification, systèmes de fichiers, arbres généalogiques)

Les diagrammes de processus montrent ce qui se passe & dans quel ordre:

- Les diagrammes de flux: décisions & séquences (algorithmes, processus métier, logique de diagnostic) - Les diagrammes de séquence: passage de messages dans le temps (appels API, protocoles, gestion d'événements) - Les machines à états: états & transitions (flux d'interface utilisateur, états de protocole, systèmes de contrôle)

Les diagrammes quantitatifs montrent combien & comment cela change:

- Les graphiques & diagrammes: données au fil du temps ou par catégorie (ligne, barre, nuage de points) - Les diagrammes de distribution: propagation & densité (histogrammes, boîtes à moustaches) - Les diagrammes de Sankey: flux avec magnitude (flux d'énergie, allocations budgétaires)

Les diagrammes spatiaux montrent où les choses se trouvent:

- Les sections transversales: structure interne (géologie, anatomie, ingénierie) - Les vues éclatées: relations d'assemblage (pièces mécaniques, électronique) - Les schémas: topologie fonctionnelle (circuits électriques, tuyauterie, CVCA)

Correspond le type au problème

La sélection du type est la première décision de conception

L'erreur la plus courante en diagrammation est de choisir un type par habitude plutôt que par ajustement. Un développeur opte pour un diagramme de flux parce qu'il utilise toujours des diagrammes de flux. Un gestionnaire opte pour un organigramme. Le type doit être choisi par ce que le diagramme doit communiquer.

Comment lire un diagramme complexe

Les diagrammes complexes ont des couches. Un lecteur qui essaie d'absorber tout à la fois se sent submergé. Un lecteur qui lit par couches extrait la structure efficacement.

Couche 1 : Inventaire. Quels nœuds existent? Quels sont les composants majeurs? Lisez chaque étiquette. Ne suivez pas les connexions encore. Construisez le vocabulaire avant de construire la grammaire.

Couche 2 : Topologie. Comment les composants sont-ils connectés? Qu'est-ce qui est connecté à quoi? Comptez les connexions. Identifiez les hubs (nombreuses connexions) & les feuilles (une connexion). Remarquez les clusters.

Couche 3 : Flux. Si les flèches existent, suivez-les. Où quelque chose entre-t-il dans le système? Où sort-il? Quel chemin suit le flux principal? Quelles sont les branches?

Couche 4 : Exceptions. Qu'est-ce qui est différent? Lignes pointillées vs. lignes solides. Codage par couleur. Formes qui diffèrent de la majorité. Ceux-ci encodent du sens : trouvez la légende & décodez-les.

Couche 5 : Inférence. Qu'est-ce que cette structure implique? Un seul hub avec de nombreuses dépendances est un point de défaillance unique. Une boucle de rétroaction implique un risque d'oscillation. Une connexion manquante implique une frontière. Lisez ce qui n'est pas dessiné aussi attentivement que ce qui l'est.

Pratique de lecture

Appliquez la méthode des cinq couches

Pensez à un diagramme complexe que vous avez rencontré dans votre domaine : un schéma de circuit, une topologie réseau, un diagramme anatomique, une architecture système, un isométrique de plomberie, une machine à états.

Principes de composition

Un diagramme qui est techniquement correct mais mal composé est quand même un diagramme échoué. L'œil du lecteur doit être guidé vers les bons endroits dans le bon ordre.

Hiérarchie par la taille & le poids. Le composant le plus important doit être le plus grand ou le plus gras. Les composants secondaires sont plus petits. Les étiquettes sont plus petites que les choses qu'elles étiquettent. L'œil lit par la proéminence.

Flux par la direction. De gauche à droite ou de haut en bas implique le temps & la séquence. Radial implique la centralité. Vertical implique la hiérarchie. Choisissez une direction & maintenez-la. Les directions mélangées créent de la confusion.

Groupement par la proximité & l'enclosure. Les composants qui se situent ensemble doivent être proches les uns des autres ou enfermés dans une frontière partagée. L'espace blanc crée une séparation. La couleur partagée ou la bordure crée une association.

Contraste par la couleur. La couleur encode du sens : mais seulement si elle est utilisée avec parcimonie. Trois à quatre couleurs distinctes est une limite. Plus que cela & la légende devient un test de mémoire. Utilisez la couleur pour encoder une dimension des données : statut, type, ou propriété.

Réduction par l'élimination. Chaque élément qui n'ajoute pas d'information soustrait de la clarté. Supprimez les éléments décoratifs. Supprimez les étiquettes que le lecteur connaît déjà. Supprimez les lignes qui n'ajoutent pas d'information. Le meilleur diagramme est celui dont on ne peut rien éliminer de plus.

Concevoir un diagramme

Appliquez les principes

Pensez à un processus ou un système dans votre domaine qui n'a pas un bon diagramme : ou en a un qui pourrait être amélioré.

Langage de diagramme standard de votre domaine

Chaque domaine professionnel a développé son propre langage de diagramme au cours des décennies. Ce ne sont pas arbitraires : ils encodent les distinctions exactes que les experts du domaine doivent communiquer.

Électricité: Les schémas utilisent des symboles standardisés (résistance, condensateur, transistor, masse, VCC). Chaque électricien au monde lit le même ensemble de symboles. Le schéma EST la spécification : un diagramme de câblage est une documentation légalement contraignante.

Mécanique: Les dessins d'ingénierie utilisent la projection orthographique, les vues en section & les callouts GD&T. Une dimension avec une tolérance est un contrat légal entre le concepteur & l'usineur. Le dessin spécifie complètement la pièce.

Logiciel: L'UML définit les diagrammes de classe, les diagrammes de séquence & la notation des machines à états. Les diagrammes d'architecture utilisent des boîtes & des flèches avec des conventions convenues pour les services, les bases de données, les files d'attente & les frontières.

Médical: Les sections anatomiques transversales, les lames de pathologie, les interprétations de radiologie. Un radiologue lit une analyse TDM comme un diagramme de structure interne : données spatiales codées par densité. Un pathologiste lit une lame tissulaire comme un diagramme de population de types cellulaires.

Métiers: Isométriques de plomberie, mises en page de conduits CVCA, plans de charpente structurale. Un plombier lisant un dessin isométrique voit les tailles de tuyau, les raccords, les pentes & les connexions de fixtures en trois dimensions sur une page bidimensionnelle.

Apprendre le langage de diagramme standard de votre domaine n'est pas optionnel pour les professionnels. C'est le vocabulaire partagé. Quelqu'un qui ne peut pas lire un schéma ne peut pas travailler en tant qu'électricien. Quelqu'un qui ne peut pas lire un dessin ne peut pas travailler en tant qu'usineur.

Synthèse finale

La compétence derrière le diagramme

Un diagramme n'est pas une image. C'est une déclaration formelle dans une langue visuelle. Comme la langue écrite, elle peut être grammaticalement correcte mais dénuée de sens, ou grammaticalement maladroite mais claire. L'objectif est les deux : l'utilisation correcte des conventions du type ET une composition qui guide le lecteur à la bonne conclusion.