9 |
|
|
10 |
UML, the blah, has recently become blah blah |
UML, the blah, has recently become blah blah |
11 |
|
|
|
Javadoc, the hypertext documentation tool that comes with |
|
|
Java (trademark of Sun Microsystems, Javadoc is distributed only |
|
|
as part of Java, non-free), is ... |
|
|
Easy to check methods, hard to get overall picture. |
|
|
Because doc is generated from source, the class, method, field |
|
|
names are always up-to-date(!!) |
|
|
|
|
|
Architectural docs using UML: little detail, may be |
|
|
slightly outdated at any particular time. However, |
|
|
good overall picture. Even outdated but well simplified diagram |
|
|
is better than too detailed, automaticly up-to dated and reverse |
|
|
engineered diagram. |
|
|
|
|
12 |
Some statements from the UML book (Booch, Jacobson, Rumbaugh, p.6) |
Some statements from the UML book (Booch, Jacobson, Rumbaugh, p.6) |
13 |
"A model is a simplification of reality." |
"A model is a simplification of reality." |
14 |
"We build models so that we can better understand the system |
"We build models so that we can better understand the system |
72 |
This page lists a lot of UML tools: |
This page lists a lot of UML tools: |
73 |
http://plg.uwaterloo.ca/~migod/uml.html |
http://plg.uwaterloo.ca/~migod/uml.html |
74 |
|
|
75 |
|
Setting of problem |
76 |
|
================== |
77 |
|
|
78 |
|
Javadoc, the hypertext documentation tool that comes with |
79 |
|
Java (trademark of Sun Microsystems, Javadoc is distributed only |
80 |
|
as part of Java, non-free), is ... |
81 |
|
|
82 |
|
- Easy to check methods, hard to get overall picture. |
83 |
|
|
84 |
|
- Because doc is generated from source, the class, method, field |
85 |
|
names are always up-to-date(!!) |
86 |
|
|
87 |
|
Architectural docs using UML: |
88 |
|
|
89 |
|
- little detail, |
90 |
|
|
91 |
|
- may be slightly outdated at any particular time. |
92 |
|
|
93 |
|
- good overall picture. |
94 |
|
|
95 |
|
- Even outdated but well simplified diagram |
96 |
|
is better than too detailed, automaticly up-to dated and reverse |
97 |
|
engineered diagram. |
98 |
|
|
99 |
|
|
100 |
Design |
Design |
101 |
====== |
====== |
102 |
|
|