Solved

Documentation Tools? Any comments?

Posted on 2004-09-22
12
284 Views
Last Modified: 2010-04-01
I am newly join a new company in town.

I notice that their code is very complicated and messy.

1. I wonder in the market or internet, any UML Tools can help to speed up the Documentation process? Is all these UML tools will help to trace the program and also let peole understand the existing code easier??

2. UML is the only way to do documentation? Any other way to "document" the code that we have developed?

3. Currently I am using WSAD.  Any UML Bundled with WSAD that can help to speed up the documentation????

Please help and share you experiece.

TQ.
0
Comment
Question by:miri5698
  • 6
  • 4
  • 2
12 Comments
 

Author Comment

by:miri5698
ID: 12121083
one more concern, the code that am reading at, is not fully OO concept.  Thus i assume the UML is hard to translate as well. :-(

Too Bad.
0
 
LVL 14

Expert Comment

by:boonleng
ID: 12121258
>1. I wonder in the market or internet, any UML Tools can help to speed up the Documentation process? Is all these UML tools will help to trace the program and also let peole understand the existing code easier??
MagicDraw http://www.magicdraw.com/ is very good. The new version can do reverse engineering from source code, but i haven't try it out :p

>2. UML is the only way to do documentation? Any other way to "document" the code that we have developed?
JavaDoc is the most common java documentation. You can use WSAD to export it (right click > Export > Javadoc).

>3. Currently I am using WSAD.  Any UML Bundled with WSAD that can help to speed up the documentation????
Beside getting the slow and expensive Rational plug-in, there's no UML tools bundle with WSAD.
0
 
LVL 21

Expert Comment

by:MogalManic
ID: 12121289
You can try these UML tools:

Question  Are there any open source/free UML tools for Java developers?  
Derived from  A question posed by Sean Sullivan  
Topics  Tools, Process:UML:Tools  
Author  Sean Sullivan  
Created  Nov 30, 2001  
 



Answer
Open-source / free tools:
  - ArgoUML http://www.argouml.org/ 
  - JUG - Java UML Generator http://jug.sourceforge.net/ 
  - UML Modeller (KDE app for Linux) http://sourceforge.net/projects/uml/ 
  - UML Library for Java http://sourceforge.net/projects/nsuml/ 
  - Quick UML for Java http://sourceforge.net/projects/quj/ 
  - UML Sculptor http://sourceforge.net/projects/umlsculptor/ 

I've played around with Argo.  It has a reverse engineer utility, but it is limited.  Even if one of these tools (You could even try the commercial tools like Rational Rose), they ONLY will reverse engineer JAVA files.  I don't think it is possible to reverse engineer JSP pages.  I'm afraid the only way to document the application is to manually draw it yourself.

I would start with an Activity Diagram, which traces the flow from page to page.  As for improving the documentation, the best way is to improve the code.  As you are going through the code, note where the code is hard to read and/or is reapeated from other places.  If all of the code is in the JSP pages, start refactoring them into MVC (Model, View, controller pattern).  Where the Model is the DB query, View is the JSP, and the Controller is a Java Action.

 
 
 
0
Free Tool: Path Explorer

An intuitive utility to help find the CSS path to UI elements on a webpage. These paths are used frequently in a variety of front-end development and QA automation tasks.

One of a set of tools we're offering as a way of saying thank you for being a part of the community.

 

Author Comment

by:miri5698
ID: 12122241
MogalManic, among all these recommanded URL,
which one have you tried?

Regarding the Activity Diagram, is that those mannual Acitivity flow diagram that you are referring? Means need to draw myself mannualY??

boonleng, thanks for the magicdraw. I will try it out. Hopefully it's help.

tq. to both of you.
0
 

Author Comment

by:miri5698
ID: 12122261
but then BoonLeng, have you tried to use MagicDraw to draw those un-OO type of code?

0
 
LVL 14

Expert Comment

by:boonleng
ID: 12122825
Im not sure what you mean "un-OO type of code",
but bad coding probably end up with a class diagram with very few relationship, everything is standalone.
then you will have to depend on the sequence diagram.

I have MagicDraw 7, tomolo i will download version 8 and try it out.
coz it can do reverse engineering to sequence diagram, most tools can only generate class diagram.

0
 
LVL 21

Expert Comment

by:MogalManic
ID: 12128690
>which one have you tried?
I've tried the ARGO UML.  It is primative.  It doesn't come near to the functionality of Microsoft Visio.  I'll have to try the other ones!!!

>Regarding the Activity Diagram, is that those mannual Acitivity flow diagram that you are referring? >Means need to draw myself mannualY??

I mean that you will have to manually figure out how the application works, and either using Pen & Paper and/or UML modeling tool, build the activity diagram.

0
 

Author Comment

by:miri5698
ID: 12131894
Friend, i haev tried the MagicDraw 8.0.

It's seems that this is normal way of coding UML. From the diagram come out with the code.

But now i am doing reverse....so, magic draw is out!!!

I am downloading Argo now...
0
 
LVL 14

Expert Comment

by:boonleng
ID: 12149070
Which version of MagicDraw8.0 you tried, only professional and enterprise version able to perform reverse engineering.

I have tried the enterprise version and able to convert the java classes to class diagram.
I also managed to reverse a simple code to sequence diagram :)
For large process flow that involve many classes is a bit difficult to reverse, i need to pratice a bit more to get it done...
0
 

Author Comment

by:miri5698
ID: 12153929
boonleng, i have tried the rational rose and downloaded the Magiscdraw personal and CE.

I notice that i manage to perform the reverse engineering. But i couldnt get the connectivity or the relationship among all my code.

Is that normal?

I want to do UML because i thought i acn have a better understanding of my overall code. :-)
0
 
LVL 14

Accepted Solution

by:
boonleng earned 500 total points
ID: 12154522
It should have generated the relationship, im using the Diagram Wizard to generate the diagram from codes.
You can compare the diagram between Rational rose and Magiscdraw to see wether correct or not.

Just found this Eclipse UML tool http://www.omondo.com/, may not be as powerful as Rational rose/Magiscdraw,
but very easy to use and able to perform reverse engineering to class diagram.
0
 

Author Comment

by:miri5698
ID: 12175957
thank you boonleng, you help a lot.

thanks
0

Featured Post

Free Tool: Port Scanner

Check which ports are open to the outside world. Helps make sure that your firewall rules are working as intended.

One of a set of tools we are providing to everyone as a way of saying thank you for being a part of the community.

Question has a verified solution.

If you are experiencing a similar issue, please ask a related question

Suggested Solutions

Title # Comments Views Activity
constuctor calling other constructor 2 80
Help with LDAp login using jsp 6 116
spring AOP 6 88
maven j2ee examles 2 60
ConnectWise and their customers need to ensure critical alerts automatically reach the right person at the right time. MSP superheros efficiently respond to these alerts key is providing automatic, intelligent alerting that generates a complete audi…
This article shows the method of using the Resultant Set of Policy Tool to locate Group Policy that applies a particular setting.
Finds all prime numbers in a range requested and places them in a public primes() array. I've demostrated a template size of 30 (2 * 3 * 5) but larger templates can be built such 210  (2 * 3 * 5 * 7) or 2310  (2 * 3 * 5 * 7 * 11). The larger templa…

830 members asked questions and received personalized solutions in the past 7 days.

Join the community of 500,000 technology professionals and ask your questions.

Join & Ask a Question