/[gzz]/manuscripts/UMLLink/umllink.rst
ViewVC logotype

Diff of /manuscripts/UMLLink/umllink.rst

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.16 by tjl, Tue Jan 21 09:14:51 2003 UTC revision 1.17 by tjl, Tue Jan 21 09:18:05 2003 UTC
# Line 9  Introduction Line 9  Introduction
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
# Line 85  MetaPhor, hypertext in soft. devel? (htt Line 72  MetaPhor, hypertext in soft. devel? (htt
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    

Legend:
Removed from v.1.16  
changed lines
  Added in v.1.17

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26