Question

I'm creating a class diagram. The purpose is communication and visualisation, not code generation or other processing, so I don't have to stick to UML rules.

I made a quick starting point with Dia, a program that I have some experience using. While it is really easy to use, it's a bit... lacking in aesthetics and functionality after all. So I downloaded and tried Modelio, Visual Paradigm, WhiteStarUML and Violet. They're all nice but don't have one feature I'd like to have.

In Dia, I'm able to simply add a comment to any class or member and show it beside the element (see picture). It makes it possible to create really informative diagrams for humans. In these other four tools I'm able to bury some documentation inside the objects to show up in a window when they're doubleclicked but it's a lot clunkier than having it visible right away. A UML note is fine with classes, but it doesn't work for smaller elements.

What diagramming tool has a way to convey informal information while still offering useful tools for structured diagrams? I certainly don't need the full set of UML intricacies, especially the non-visible (like unique or ordered collections etc.), but also more than just arrows and boxes.

The diagram

No correct solution

OTHER TIPS

Not only on class diagrams, but on all UML diagrams it is the common element and it is called Note. Very important one, really.

enter image description here

Up to the standard, you can write something to any element, but this something will never be comments. Except the case of Note.

In Enterprise Architect you can show the comments of an element its own section.

Class with comment

Comments of features cannot be shown inline, but you can add a note that shows the comments of a specific feature.

Licensed under: CC-BY-SA with attribution
Not affiliated with StackOverflow
scroll top