[Gzz-commits] manuscripts/UMLLink article.rst

[Tuukka Hastrup]

CVSROOT:        /cvsroot/gzz
Module name:    manuscripts
Changes by:     Tuukka Hastrup <address@hidden> 03/02/11 10:19:40

Modified files:
        UMLLink        : article.rst 

Log message:
        suggestions for terminology and conceptual model

CVSWeb URLs:
http://savannah.gnu.org/cgi-bin/viewcvs/gzz/manuscripts/UMLLink/article.rst.diff?tr1=1.2&tr2=1.3&r1=text&r2=text

Patches:
Index: manuscripts/UMLLink/article.rst
diff -u manuscripts/UMLLink/article.rst:1.2 manuscripts/UMLLink/article.rst:1.3
--- manuscripts/UMLLink/article.rst:1.2 Mon Feb 10 14:19:42 2003
+++ manuscripts/UMLLink/article.rst     Tue Feb 11 10:19:39 2003
@@ -2,7 +2,7 @@
 A free software toolchain for bidirectional linking between UML diagrams and 
Javadoc
 
====================================================================================
 
-:Stamp: $Id: article.rst,v 1.2 2003/02/10 19:19:42 tuukkah Exp $
+:Stamp: $Id: article.rst,v 1.3 2003/02/11 15:19:39 tuukkah Exp $
 
 
 
@@ -92,6 +92,32 @@
  * easy to document: any rst can contain UML (what about explicitly in 
    Javadoc?)
 
+Conceptual model (for HT people!)
+=================================
+
+* Java class: node
+* Java package: hierarchical classification of nodes, also node
+
+* Documentation: the hypertext universe
+    * the two distinct pieces of documentation: originally no cross-links
+        * source code documentation as javadoc-format comments; translated to 
+          HTML pages by Sun's Javadoc tool
+        * architectural documentation (and PEGs) which may contain UML diagrams
+          as rst-format files; translated to architecture documents 
+          (documentation nodes?)
+
+* UML diagrams: distinct context for Java classes and packages and relevant 
+  architectural documentation; spatial menu; also node (XXX multi-ended nexus
+  links)
+
+* Cross-reference by Javadoc: cheap cross-link
+* Cross-link from javadoc comments: simple hyperlink
+* Indexes by Javadoc: hierarchy navigation tool 
+  (poorly implemented as WWW)
+
+* Links in UML diagrams: context navigation links
+
+* (XXX Free Software vs. Open Source vs. Open Software vs. Open Project...)
 
 Introduction
 ============