--- David Jencks <[EMAIL PROTECTED]> a
écrit : > On 2002.12.14 14:01:45 -0500 wonder sonic
wrote:
> > Well, it's a sort of answer I really appreciate
> > (seriously). However, I think it should be
> detailed.
> > 
> > -1- Where should those diagrams reside? in the
> same
> > directories of the java files or in an other
> directory
> > named diagrams (for example).
> > 
> > -2- AFAIK, only the ones who have designed the
> > different modules might create the best UML
> diagrams
> > (activity, usecase...). I haven't the impertinence
> to
> > say that I could do that! :)
> > 
> > -3- A synchronization problem could occur for the
> > developers who don't have such tools: modification
> of
> > the source code whitout modification of the
> diagrams.
> 
> I think this is a really serious problem.  
> I also think most developers don't think uml
> diagrams work very well for the kind of 
> "meta-programming" done in a lot of the server 
> core. 

Could you please explain what you mean by
"meta-programming"?

> I haven't tried, but would be happy if
> this was demonstrated to be wrong.

In most cases, UML diagrams could help to communicate
new developments design, explain *quickly* the
dependencies between packages, classes and interfaces,
show the logic of an algorithm... Moreover, the fact
that UML is a graphical language reduces the
explanation of a complex algorithm for example:
-
http://www.visualuml.com/Sample%20Diagrams/Fig%209-1%20Activity%20Diagram.jpg
-
http://msdn.microsoft.com/library/en-us/f_and_m/html/vxfm7_topleveldiagram.gif
-
http://www.smartdraw.com/resources/centers/flowcharts/images/flowchart_deployment_example.gif

> > 
> > -4- Perhaps some Together project files could be
> > added?
> 
> Who is going to keep them in sync?  Out of date is
> worse than not there.

Indeed! In fact, we can consider UML diagrams as a
complement to javadoc. When a development is done,
javadoc should be synchronized with it, UML diagrams
should be synchronized the same way.
The main problem is how can developers update UML
diagrams? An open source tool would be welcome.

> > 
> > -5- I can personnaly create class diagrams for the
> > JBoss modules. What format shall I use? wmf, gif,
> > Together (v6)?
> 
> I suggest xmi using argo/poseidon.

Yes, xmi is a standard for UML diagrams. But they only
are useful to those who can use them with the right
tool. I think an image format could be used too for
those who don't have such tool.

WS

> 
> david jencks
> > 
> > WS
> > 
> >  --- Bill Burke <[EMAIL PROTECTED]> a écrit : > You
> want
> > it. Do it.
> > > 
> > > 
> > > XXXXXXXXXXXXXXXX
> > > Bill Burke
> > > Chief Architect
> > > JBoss Group, LLC
> > > XXXXXXXXXXXXXXXX
> > > 
> > > 
> > > > -----Original Message-----
> > > > From:
> > > [EMAIL PROTECTED]
> > > >
> > >
> >
>
[mailto:[EMAIL PROTECTED]]On
> > > Behalf Of
> > > > wonder sonic
> > > > Sent: Saturday, December 14, 2002 12:24 PM
> > > > To: [EMAIL PROTECTED]
> > > > Subject: [JBoss-dev] JBoss and UML?
> > > >
> > > >
> > > > Hello,
> > > > Looking the source code of the 4.0.0alpha
> version,
> > > > I noticed the presence of Together diagrams in
> the
> > > > jboss.net/testsuite directory. Wouldn't it be
> > > useful
> > > > to add such development documentation (UML
> > > diagrams,
> > > > not only classes diagrams) to other modules?
> > > >
> > > > I think it could help new developers who wish
> to
> > > > contribute.
> > > >
> > > > Best regards,
> > > > WS
> > > >
> > > >
> > >
> >
>
___________________________________________________________
> > > > Do You Yahoo!? -- Une adresse @yahoo.fr
> gratuite
> > > et en français !
> > > > Yahoo! Mail : http://fr.mail.yahoo.com
> > > >
> > > >
> > > >
> > >
> >
>
-------------------------------------------------------
> > > > This sf.net email is sponsored by:
> > > > With Great Power, Comes Great Responsibility
> > > > Learn to use your power at OSDN's High
> Performance
> > > Computing Channel
> > > > http://hpc.devchannel.org/
> > > >
> _______________________________________________
> > > > Jboss-development mailing list
> > > > [EMAIL PROTECTED]
> > > >
> > >
> >
>
https://lists.sourceforge.net/lists/listinfo/jboss-development
> > > 
> > > 
> > > 
> > >
> >
>
-------------------------------------------------------
> > > This sf.net email is sponsored by:
> > > With Great Power, Comes Great Responsibility 
> > > Learn to use your power at OSDN's High
> Performance
> > > Computing Channel
> > > http://hpc.devchannel.org/
> > > _______________________________________________
> > > Jboss-development mailing list
> > > [EMAIL PROTECTED]
> > >
> >
>
https://lists.sourceforge.net/lists/listinfo/jboss-development
> 
> > 
> >
>
___________________________________________________________
> > Do You Yahoo!? -- Une adresse @yahoo.fr gratuite
> et en français !
> > Yahoo! Mail : http://fr.mail.yahoo.com
> > 
> > 
> >
>
-------------------------------------------------------
> > This sf.net email is sponsored by:
> > With Great Power, Comes Great Responsibility 
> > Learn to use your power at OSDN's High Performance
> Computing Channel
> > http://hpc.devchannel.org/
> > _______________________________________________
> > Jboss-development mailing list
> > [EMAIL PROTECTED]
> >
>
https://lists.sourceforge.net/lists/listinfo/jboss-development
> > 
> > 
> 
> 
>
-------------------------------------------------------
> This sf.net email is sponsored by:
> With Great Power, Comes Great Responsibility
> Learn to use your power at OSDN's High Performance
> Computing Channel
> http://hpc.devchannel.org/
> _______________________________________________
> Jboss-development mailing list
> [EMAIL PROTECTED]
>
https://lists.sourceforge.net/lists/listinfo/jboss-development 

___________________________________________________________
Do You Yahoo!? -- Une adresse @yahoo.fr gratuite et en français !
Yahoo! Mail : http://fr.mail.yahoo.com


-------------------------------------------------------
This sf.net email is sponsored by:
With Great Power, Comes Great Responsibility 
Learn to use your power at OSDN's High Performance Computing Channel
http://hpc.devchannel.org/
_______________________________________________
Jboss-development mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/jboss-development

Reply via email to