This week's book giveaway is in the OO, Patterns, UML and Refactoring forum. We're giving away four copies of Refactoring for Software Design Smells: Managing Technical Debt and have Girish Suryanarayana, Ganesh Samarthyam & Tushar Sharma on-line! See this thread for details.
Its definitely not a freeware,
but when i think about any type of architecture diagrams i prefer visio.
ease of use 10/10
extensibility : you can make your own "stencils" and use them in any diagrams
portability: I love the export to "EMF" format. EMF (Enhanced Meta File) is a format supported by XP by default and is a vector oriented format (just zoom !!)
also its support in MS Word (direct paste) is good which in my opinion is what you are going to resort to, to do the documentation (unless you are a Linux guy)
Export to JPG,Gif, etc.
You cant expect it to generate code from uml diagrams (At least I have not discovered this)
We started working on a new project which is a software maintenance project. We are asked to document the existing code and existing functionality in the project. If we have to document the existing code then I can think of
a. code call flows
b. sequence diagrams
c. data models
d. use cases
e. business process diagrams
Now my question is, can you share your experiences how to document the existing code ? any books on documenting code ? any urls ? how to layout the document ? what to put first in the document and what to last in the document ? etc.
appreciate your help.
Joined: Apr 18, 2006
appreciate any JavaRancher's willing to contribute to my post ...
Take a look at ArgoUML from tigris.org. It was adapted to become the commercial product Poseidon from gentleware (they have a "free version. but it lacks some features).
ArgoUML is fairly mature, although it lacks a little polish. Though in part that's because UML is a standard that tends to get interpreted pretty freely, so they spend a lot of time figuring out the best way to represent things.
I got extremely frustrated trying to do UML in Visio. It had this insane idea I was trying to develop a Visual Basic application. And these days, I don't run Windows, so it's not even a viable option anymore.
Customer surveys are for companies who didn't pay proper attention to begin with.