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. |
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 |
============ |
============ |
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 |
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 |
|
|
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] |
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 |
|
|