[Top][All Lists]
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Gzz-commits] manuscripts/UMLLink umllink.rst
From: |
Tuomas J. Lukka |
Subject: |
[Gzz-commits] manuscripts/UMLLink umllink.rst |
Date: |
Tue, 21 Jan 2003 04:18:30 -0500 |
CVSROOT: /cvsroot/gzz
Module name: manuscripts
Changes by: Tuomas J. Lukka <address@hidden> 03/01/21 04:18:05
Modified files:
UMLLink : umllink.rst
Log message:
Reorg
CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/manuscripts/UMLLink/umllink.rst.diff?tr1=1.16&tr2=1.17&r1=text&r2=text
Patches:
Index: manuscripts/UMLLink/umllink.rst
diff -u manuscripts/UMLLink/umllink.rst:1.16
manuscripts/UMLLink/umllink.rst:1.17
--- manuscripts/UMLLink/umllink.rst:1.16 Tue Jan 21 04:14:51 2003
+++ manuscripts/UMLLink/umllink.rst Tue Jan 21 04:18:05 2003
@@ -2,26 +2,13 @@
A free software toolchain for bidirectional linking between UML diagrams and
Javadoc
====================================================================================
-:Last-Modified: $Date: 2003/01/21 09:14:51 $
+:Last-Modified: $Date: 2003/01/21 09:18:05 $
Introduction
============
UML, the blah, has recently become blah blah
-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.
-
Some statements from the UML book (Booch, Jacobson, Rumbaugh, p.6)
"A model is a simplification of reality."
"We build models so that we can better understand the system
@@ -84,6 +71,31 @@
This page lists a lot of UML tools:
http://plg.uwaterloo.ca/~migod/uml.html
+
+Setting of problem
+==================
+
+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.
+
+ - good overall picture.
+
+ - Even outdated but well simplified diagram
+ is better than too detailed, automaticly up-to dated and reverse
+ engineered diagram.
+
Design
======
- [Gzz-commits] manuscripts/UMLLink umllink.rst, (continued)
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Asko Soukka, 2003/01/15
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Asko Soukka, 2003/01/15
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Asko Soukka, 2003/01/17
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/20
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Asko Soukka, 2003/01/20
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst,
Tuomas J. Lukka <=
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Asko Soukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21
- [Gzz-commits] manuscripts/UMLLink umllink.rst, Tuomas J. Lukka, 2003/01/21