[Gzz-commits] manuscripts/UMLLink umllink.rst

[Asko Soukka]

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

Modified files:
        UMLLink        : umllink.rst 

Log message:
        solving getting-lost in hypertext

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

Patches:
Index: manuscripts/UMLLink/umllink.rst
diff -u manuscripts/UMLLink/umllink.rst:1.44 
manuscripts/UMLLink/umllink.rst:1.45
--- manuscripts/UMLLink/umllink.rst:1.44        Fri Jan 24 04:20:26 2003
+++ manuscripts/UMLLink/umllink.rst     Fri Jan 24 06:44:06 2003
@@ -2,7 +2,7 @@
 A free software toolchain for bidirectional linking between UML diagrams and 
Javadoc
 
====================================================================================
 
-:Stamp: $Id: umllink.rst,v 1.44 2003/01/24 09:20:26 humppake Exp $
+:Stamp: $Id: umllink.rst,v 1.45 2003/01/24 11:44:06 humppake Exp $
 
 Issues
 ======
@@ -105,9 +105,21 @@
     large tools like Rational Rose (also ideological reasons
     to use open source, though open code is always extensible)
      
-  + the point of good documentation is getting rid of the
+  + the point of good and documentation is to reduce the
     Mythical Man of Month effect [brooks-mythical-man-month];
-    lowering threshold for new people
+    lowering threshold for new people; help intercommunication
+    within the group
+
+    - [p. 16] "Men and months are interchangeable commodities only
+      when a task can be partitioned among many workers with no
+      communication."
+    - [p. 17] "In tasks that can be partitioned but which require
+      communication among subtasks, the effort of communication
+      must be added to the amount of work to be done."
+    - [p. 18] "The added burden of communication is made up of two
+      parts, training and intercommunication. Each worker must be trained
+      in the technology, the goasl of the effort, the overall strategy, and
+      the plan of work." "Intercommunication is worse."
 
 UML
 ---
@@ -131,7 +143,7 @@
    language over menus and dialogs when creating UML objects 
 
    + we need a ref. of criticism of direct manipulation!
-
+     - TODO: Computer 16, 8 Ben Scheiderman 57-69
      - "The dark side of a direct manipulation interface is that
        you have to directly manipulate everything. Instead of an
        executive who gives high-level instructions, the user is 
@@ -250,7 +262,23 @@
     hard to find?
 
  + hypertext disorientation problem still exists with javadoc
-   [edward-hardman-lost-in-hyperspace]
+
+   TODO: "According to Conklin, on of the major problems of hypertext, is that 
+   of disorientation or "getting lost" in a display network"
+   Computer 20, 9 Conklin, J. Hypertext: An introduction and survey 17-41
+
+   "--individuals appear to be attempting to create cognitive
+   representations of hypertext structures in the form of a survey-type
+   map--"
+  
+   "Readers should be allobwed to develop a cognitive map of one view
+   of the data structure before being given the opinion of navigating 
+   through the data some other way."
+    
+   "The mos appropriate types of navigation
+   devices would be those that are spatially based." 
+
+   [edward-hardman-lost-in-hyperspace, p.123] 
 
 "Obvious" question: can we increase the overall value by
 interconnecting the two?