[Gzz-commits] manuscripts/UMLLink umllink.rst

[Asko Soukka]

CVSROOT:        /cvsroot/gzz
Module name:    manuscripts
Changes by:     Asko Soukka <address@hidden>    03/01/15 06:29:50

Modified files:
        UMLLink        : umllink.rst 

Log message:
        UMLink

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

Patches:
Index: manuscripts/UMLLink/umllink.rst
diff -u manuscripts/UMLLink/umllink.rst:1.1 manuscripts/UMLLink/umllink.rst:1.2
--- manuscripts/UMLLink/umllink.rst:1.1 Thu Dec 12 13:38:47 2002
+++ manuscripts/UMLLink/umllink.rst     Wed Jan 15 06:29:50 2003
@@ -1,16 +1,38 @@
 A free software toolchain for bidirectional linking between UML diagrams and 
Javadoc
 
====================================================================================
 
+tarvitaan:
+- suoramanipulointikritiikkiä (nopea kaavioiden luonti kirjoittamisen ohessa 
tjsp)
+
+seurataan RST:n filosofiaa (sisennys blokeille, robusti, "luonnollinen", ASCII,
+rakenne ja piirto erikseen)
+
 Previous work
 =============
 
 Rational Rose
+Dia (drawing, generating code templates)
+doc++ (osaa generoida hyödyttömiä kaavioita koodista)
+ -miksi hyödyttömiä?
 
 Design
 ======
 
+Lähtökohtina:
+- erillinen arkkitehtuuridokumentaatio (ihmiseltä ihmiselle), _olennaiset_
+  arkitehtoniset piirteet (esimerkiksi rakenteet, kutsusekvenssi)
+- tarkka koodista generoitu javadoc (tai muu) (kertoo yksityiskohdat, ei 
yleiskuvaa)
+
+- halutaan piirtää kaaviot itse (UML-kirja)
+- nähdään luokan dokumentaatiosta helposti, missä siitä on mainittu jossan 
(viittaukset)
+
+- kieli, ei suoramanipulaatiota
+
 Goals:
     
+    - päämääränä ei ole koodin generointi kaavioista (kuten esimerkiksi 
metaedit/RationalRose) eikä
+      kaavioiden generointi koodista (RationalRose)
+
     - light-weight
 
     - using existing free software tools
@@ -29,6 +51,8 @@
 
     - placement: currently metapost; looking at ways to make interactively
       editable.
+      + elementin luonti kielellä
+      + graafinen sijoittelu suoramanipulaatiolla
 
 
 UML diagram of how architectural documents, UML diagrams and javadoc pages 
work.