/[gzz]/manuscripts/UMLLink/umllink.rst
ViewVC logotype

Diff of /manuscripts/UMLLink/umllink.rst

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.48 by humppake, Mon Jan 27 10:38:17 2003 UTC revision 1.49 by humppake, Mon Jan 27 14:19:38 2003 UTC
# Line 43  Issues Line 43  Issues
43        live within information flood)        live within information flood)
44      - blind users exists      - blind users exists
45    
46        - Rational Soda is WYSIWYG, maybe this could be discussed under
47          it
48    
49  - why even outdated but well simplified diagram  - why even outdated but well simplified diagram
50    is better than too detailed, automaticly up-to dated    is better than too detailed, automaticly up-to dated
51    and reverse engineered diagram.    and reverse engineered diagram.
# Line 56  Issues Line 59  Issues
59            
60  - how rational rose links diagrams into code and documentation?  - how rational rose links diagrams into code and documentation?
61    
62      STILL UNRESOLVED :( Probably all documentation is stored in      PARTIAL RESOLUTION: Probably all documentation is primary stored
63      its datamodel and when generating sourcecode, the documentation      within its own datamodel. The documentation within datamodel could
64      is embedded into source as comments. Documentation in the datamodel      be browsed at least by Rose's hierachical tree menu. Implementation
65      could at least be browsed through hierarchical tree view, don't know      of cross-hierarchical links and browsin along them still unkown.
66      yet about cross-hierarchical links...      When generating sourcecode, the documentation could be embedded into
67        source as comments. Some user comment didn't like Rose's way of
68        adding extra comments into generated code <http://c2.com/cgi/wiki?RationalRose>
69    
70  Introduction  Introduction
71  ============  ============
# Line 81  unifying software architecture design an Line 86  unifying software architecture design an
86     from the code or the code from the documentation     from the code or the code from the documentation
87     (antont's note about duplication of data problem)     (antont's note about duplication of data problem)
88    
89       [harrison-barton-raghavachari00java-to-uml]
90       [pierce-tilley02connecting-documentation-rose]
91      
92  In this article, we present the tools we developed  In this article, we present the tools we developed
93  for using UML diagrams as multiple-ended hyperlinks  for using UML diagrams as multiple-ended hyperlinks
94  between the architectural documents and javadoc generated  between the architectural documents and javadoc generated
# Line 151  UML Line 159  UML
159    
160  Rational Rose  Rational Rose
161    
162     - part of rational devtool suite
163    
164   - quite comprehensive UML design tool for different diagrams (class,   - quite comprehensive UML design tool for different diagrams (class,
165     sequence, state...) with direct manipulation interface     sequence, state...) with direct manipulation interface
   
166   - can reverse engingeer diagrams from existing source code   - can reverse engingeer diagrams from existing source code
167    
168     - co-operating with Rational Soda, Soda is WYSIWYG
169       [pierce-tilley02connecting-documentation-rose]
170    
171   - though, because we are coders, we would prefer UML script   - though, because we are coders, we would prefer UML script
172     language over menus and dialogs when creating UML objects     language over menus and dialogs when creating UML objects
173    
# Line 202  Rational Rose Line 214  Rational Rose
214         practical point of using the same writing tool foor coding and         practical point of using the same writing tool foor coding and
215         documenting.         documenting.
216    
217       + Rose's problem with direct manipulation: a lot of windows,
218         menus, dialogies etc... to get direct manipulateable graphic
219         representation for everything
220    
221     + though, directmanipulation is only relevant solution for     + though, directmanipulation is only relevant solution for
222       replacing already created objects       replacing already created object
223    
224     - proprietary
225    
226  Dia (drawing, generating code templates)  Dia (drawing, generating code templates)
227    
228   - more a drawing than design tool   - more a drawing than a design tool
229   - could be used instead of metapost, but   - could be used instead of metapost, but
230     direct manipulation problem again     direct manipulation problem again
231     - open source
232    
233  Doxygen  Doxygen
234    
235   - can generate useless diagrams from the code class hierarchy   - can generate useless diagrams from the code class hierarchy
236   - should describe somewhere why these are useles...   - should describe somewhere why these are useles...
237     - uses non open source graphviz
238    
239    
240  MetaPhor, hypertext in soft. devel? [metaphor]  MetaPhor, hypertext in soft. devel? [metaphor]
# Line 231  MetaPhor, hypertext in soft. devel? [met Line 251  MetaPhor, hypertext in soft. devel? [met
251     + could be used to create domain spesific languages, when generating     + could be used to create domain spesific languages, when generating
252       code can really work       code can really work
253    
254    (We found no open source alternativa to our own development, which
255    combines all the good parts we need from previous tools without
256    reformin dramatically our workin culture.)
257    
258  Javadoc  Javadoc
259  -------  -------
260    

Legend:
Removed from v.1.48  
changed lines
  Added in v.1.49

savannah-hackers-public@gnu.org
ViewVC Help
Powered by ViewVC 1.1.26