474 |
|
|
475 |
.. XXX |
.. XXX |
476 |
|
|
477 |
XXX linking UML diagrams |
linking UML diagrams |
478 |
------------------------ |
------------------------ |
479 |
|
|
480 |
.. could the table be replaces? removed? |
.. could the table be replaces? removed? |
888 |
Practical use |
Practical use |
889 |
============= |
============= |
890 |
|
|
891 |
The tool is currently in everyday use in the Gzz project ... |
The UML and linking tools are currently in everyday use in the Gzz |
892 |
|
project [gzz]_. For now, the projects covers about 380 Java classes |
893 |
- n classes, n diagrams, n pages architecture documentation, and works |
and over 80 pages of design documentation have been written |
894 |
|
[gzz_doc_himalia]_. There are only about 30 different human drawn UML |
895 |
screenshots |
diagrams embedded within the design documentation pages, but the |
896 |
|
amount of them is continuosly growing. For all those diagrams the |
897 |
|
linking tool generates more than 150 different differently focused |
898 |
|
versions and by simply calculation the linking tool has embedded a |
899 |
|
single diagram implicitly on an avarage into four distinct design |
900 |
|
documentation or Javadoc pages. The UML tool description language |
901 |
|
covers currently 26 different diagram itemtypes and its being extended |
902 |
|
always when necessary. |
903 |
|
|
904 |
.. figure:: umldoc-screenshot.gen.eps |
.. figure:: umldoc-screenshot.gen.eps |
905 |
:environment: figure* |
:environment: figure* |
906 |
:width: 16.9cm |
:width: 16.9cm |
907 |
:label: screenshot |
:label: screenshot |
908 |
|
|
909 |
Collection of screenshots. Links via UML diagrams are |
Collage of screenshots from Gzz project documentation [gzz_doc_himalia]_. |
910 |
marked with red. |
The red lines and rounded rectangles are added afterwards to show |
911 |
|
how UML diagrams crosslink the design documentation and Javadoc pages. |
912 |
|
|
913 |
Discussion |
Discussion |
914 |
========== |
========== |
981 |
Acknowledgments |
Acknowledgments |
982 |
=============== |
=============== |
983 |
|
|
984 |
antont |
The authors would like to thank Toni Alatalo for discussions regarding |
985 |
|
this manuscript and Benja Fallenstein for discussions, proof reading |
986 |
benja |
and his participation for implementing the linking tool. |
987 |
|
|
988 |
.. bibliography:: gzigzag |
.. bibliography:: gzigzag |
989 |
|
|