Effectivement, le schéma original de Paypal est illisible, le tient est nettement mieux. Je soupçonne d'ailleurs celui de Paypal d'avoir été généré automatiquement d'après le code :)
L'idéal, ça reste d'avoir l'UML pour les relations entre les classes et une description en langage naturel pour les paramètres/attributs et les trucs un peu complexes.
Dans l'exemple de Paypal, ce que j'ai fais, c'est survoler la page décrivant l'API en langage naturel, puis j'ai jetté un oeil au diagramme version PlantUML pour voir un peu où sont les liaisons et je suis revenu à la description textuelle pour comprendre les détails.
Bref, c'est un peu comme toujours, c'est un outil intéressant quand il est bien utilisé et ça ne sert à rien d'avoir uniquement des schémas UML comme documentation. Mais bon, ça permet d'avoir une vision global des liens entre les objets.
[^] # Re: uml c'est aussi utile que ... rien
Posté par Jux . En réponse à la dépêche PlantUML, un nouvel outil de génération UML. Évalué à 4.
L'idéal, ça reste d'avoir l'UML pour les relations entre les classes et une description en langage naturel pour les paramètres/attributs et les trucs un peu complexes.
Dans l'exemple de Paypal, ce que j'ai fais, c'est survoler la page décrivant l'API en langage naturel, puis j'ai jetté un oeil au diagramme version PlantUML pour voir un peu où sont les liaisons et je suis revenu à la description textuelle pour comprendre les détails.
Bref, c'est un peu comme toujours, c'est un outil intéressant quand il est bien utilisé et ça ne sert à rien d'avoir uniquement des schémas UML comme documentation. Mais bon, ça permet d'avoir une vision global des liens entre les objets.