Solved

Documentation Tools? Any comments?

Posted on 2004-09-22
12
279 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
 

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
Is Your Active Directory as Secure as You Think?

More than 75% of all records are compromised because of the loss or theft of a privileged credential. Experts have been exploring Active Directory infrastructure to identify key threats and establish best practices for keeping data safe. Attend this month’s webinar to learn more.

 
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

Is Your Active Directory as Secure as You Think?

More than 75% of all records are compromised because of the loss or theft of a privileged credential. Experts have been exploring Active Directory infrastructure to identify key threats and establish best practices for keeping data safe. Attend this month’s webinar to learn more.

Question has a verified solution.

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

Suggested Solutions

Title # Comments Views Activity
what is stuck threads? 3 97
communication with a non technical owner 16 101
tomcat users xml 7 105
How to Post an If Statement in JSP 3 51
When we talk about DevOps toolchains, I sometimes wonder how many people really get what we’re talking about. I don’t know if it’s just semantics or tone or something else, but sometimes I think it just sounds like buzzword sausage. So it’s always …
Cloud-based technologies and services will continue to grow in popularity in 2017 thanks to the simple, scalable and cost-effective solutions they deliver. Here are three areas where cloud adoption is poised to really take off.
Along with being a a promotional video for my three-day Annielytics Dashboard Seminor, this Micro Tutorial is an intro to Google Analytics API data.
Internet Business Fax to Email Made Easy - With  eFax Corporate (http://www.enterprise.efax.com), you'll receive a dedicated online fax number, which is used the same way as a typical analog fax number. You'll receive secure faxes in your email, f…

920 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

Need Help in Real-Time?

Connect with top rated Experts

14 Experts available now in Live!

Get 1:1 Help Now