55 |
\end{abstract} |
\end{abstract} |
56 |
|
|
57 |
|
|
58 |
|
.. raw:: latex |
59 |
|
|
60 |
|
\category{H.5.4}{Information Interfaces and Presentation}{Hy\-per\-text/Hy\-permedia}[Navigation] |
61 |
|
\category{D.2.2}{Software Engineering}{Design Tools and Techniques}[Evolutionary prototyping] |
62 |
|
\terms{Design,Documentation,Human Factors} |
63 |
|
\keywords{imagemap,maps,bi-directional linking,link authoring,UML,spatial hypertext} |
64 |
|
|
65 |
|
|
66 |
Introduction |
Introduction |
67 |
============ |
============ |
68 |
|
|
72 |
Design documentation shows |
Design documentation shows |
73 |
architectural views on a more general level, while |
architectural views on a more general level, while |
74 |
the source code usually contains |
the source code usually contains |
75 |
embedded documentation such as Javadoc [friendly95javadoc]_ giving details on the concrete |
embedded documentation, such as Javadoc [friendly95javadoc]_, giving details on the concrete |
76 |
classes and methods. |
classes and methods. |
77 |
|
|
78 |
.. Since these parts of documentation are semantically dependent |
.. Since these parts of documentation are semantically dependent |
209 |
|
|
210 |
The Unified Modeling Language (UML) is the standard way to visually |
The Unified Modeling Language (UML) is the standard way to visually |
211 |
describe software architectures and constructs in diagrams |
describe software architectures and constructs in diagrams |
212 |
[booch-jacobson-rumbaugh98uml-user-guide]_. As a standard it is a |
[booch-jacobson-rumbaugh98uml-user-guide]_. It is a |
213 |
natural part of software design documentation, because it functions as |
natural part of software design documentation because it functions as |
214 |
a common language for communication within a software development |
a common language for communication within a software development |
215 |
team. Each UML diagram is meant to expose a particular aspect |
team. Each UML diagram is meant to expose a particular aspect |
216 |
of the design. |
of the design. |