search

cxbrooks / test

Second test for bugzilla to git
0 stars 0 forks source link

The UML Diagrams need updating #53

Open cxbrooks opened 17 years ago

cxbrooks commented 17 years ago

Note: the issue was created automatically with bugzilla2github tool

Original bug ID: BZ#56 From: @cxbrooks Reported version: 7.1.devel

cxbrooks commented 17 years ago

The design doc uses Visio for the UML diagrams. Microsoft made the UML facility in Visio useless for our purposes. http://embedded.eecs.berkeley.edu/dopcenter/faq/11.html says: Note that Visio 2000 will not read our [Visio 5] UML diagrams. Moreover, the UML editor in Visio 2000 is pretty close to useless in my view... For example, you cannot refer to any class you have not defined in the diagram, so every diagram has to be completely self-contained. In effect, to create a UML diagram for Vergil, you have to include a UML diagram for all of Ptolemy II...

Another issue:

Visio 2000 has a pretty incredible bug in it... If you save a file in Visio

5 format, it works. But then you can't close the file. It asks you if you want to save it. If you say yes, it asks you if you want to save it in Visio 5 format. If you say yes, then it saves it, but leaves it open. If you try to close it, it asks you if you want to save it... etc. If you click "no" in response to the question of whether you want to save it, it deletes the file !!!!!!!!!!!!!! Gone!!!!!!!!!!!!

After looking at lots of tools, probably the best thing is to use the Shareware UML stencils from http://www.softwarestencils.com/uml/index.html

The bug here is to go through the design doc and update that UML diagrams according to the style guide in ptIIdoc/doc/uml/README.txt.

cxbrooks commented 16 years ago

See also, "What tools are available for UML Diagrams?" http://embedded.eecs.berkeley.edu/dopcenter/faq/115.html