[Gzz-commits] manuscripts/UMLLink umllink.rst

[Asko Soukka]

CVSROOT:        /cvsroot/gzz
Module name:    manuscripts
Changes by:     Asko Soukka <address@hidden>    03/01/15 09:00:02

Modified files:
        UMLLink        : umllink.rst 

Log message:
        UMLLink

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

Patches:
Index: manuscripts/UMLLink/umllink.rst
diff -u manuscripts/UMLLink/umllink.rst:1.3 manuscripts/UMLLink/umllink.rst:1.4
--- manuscripts/UMLLink/umllink.rst:1.3 Wed Jan 15 06:30:20 2003
+++ manuscripts/UMLLink/umllink.rst     Wed Jan 15 08:59:59 2003
@@ -1,11 +1,13 @@
 A free software toolchain for bidirectional linking between UML diagrams and 
Javadoc
 
====================================================================================
 
+IEEE
+ACM
+
 tarvitaan:
 - suoramanipulointikritiikkiä (nopea kaavioiden luonti kirjoittamisen ohessa 
tjsp)
-
-seurataan RST:n filosofiaa (sisennys blokeille, robusti, "luonnollinen", ASCII,
-rakenne ja piirto erikseen)
+- nimi käyttöliittymän "olet tässä" korostukseen
+- "Kaavio on valikko."
 
 Previous work
 =============
@@ -20,6 +22,24 @@
 Design
 ======
 
+Ensin lukijan näkökulma.
+
+Asekl 0 Aluksi erillinen arkkitehtuuridokumentaatio ja javadoc (ei linkkejä).
+Askel 1 linkit arkkitehtuuridokumentaation UML-kaavioista javadockiin
+ ei riitä, koska blaa
+Askel 2 UML-kaavioiden implisiittinen sijoitus javadociin, ei hyväratkaisu, 
koska 
+Askel 3 paluulinkit, jolloin UML-diagrammeista tule navigaatiovalikkoja 
(paluulinkit osa UML-kaaviota, valikkometafora, kuvan pysyvyys ja korostus)
+
+Kirjoittajan näkökulma
+
+seurataan RST:n filosofiaa (sisennys blokeille, robusti, "luonnollinen", ASCII,
+rakenne ja piirto erikseen)
+ - alhainen kynnys tehdä kaavio
+ - diagrammit samassa RST-sorsassa, pieni kynnys (jos osaa kielen)
+ - vain tieto tarkasta luokasta, ts. yksi eksplisiittinen linkki
+ - paluulinkit implisiittisiä
+
+
 Lähtökohtina:
 - erillinen arkkitehtuuridokumentaatio (ihmiseltä ihmiselle), _olennaiset_
   arkitehtoniset piirteet (esimerkiksi rakenteet, kutsusekvenssi)
@@ -65,8 +85,23 @@
 they relate to. They function like navigation bars on the WWW, except that
 the same page may have several of them.
 
+Implementation
+==============
+
+-free software ketju chain
+-flow diagram
+
+
 Practical use
 =============
 
+- n luokkaa, n kaaviota, n arkkitehtuurikaaviota ja toimii
+- vapaa softa => tärkeää, että helppo päästä sisään, tarve
+  hyvälle dokumentaatiolle (tjsp)
+
 Conclusion
 ==========
+
+- sijoittelun helpottaminen (ei kuitenkaan automaatista sijoittelua)
+- diagrammin virheiden raportointi vaatii kehitystä
+- on mahdollista, että vaihdamme metapostia (virheiden kryptisyys, kääntämisen 
hitaus) (oma UML-kieli säilyy samana)
\ No newline at end of file