Re: Documentation tools



1)the interaction/association of different modules
2)business flow of each module/functionality
What tools do I need?

I'd say
UML Static structure (class) diagrams for (1)
UML Activity / State diagrams for (2)
Perhaps with Interaction (sequence) diagrams for complex situations where timing is relevant

Tools:
If it is just for documentation and no need to generate code:
Uml Explorer (integrates in your Delphi IDE)
http://www.modelmakertools.com/uml-explorer/index.html
This will auto visualize most structural relations in a class diagrams
Automatic means: using a visualization wizard you select source fles,
select the classes to visualize and select the relations you want to see:
inheritance, using etc.) and a diagram is created on the fly.

If you want more Uml power and to be able to generate code too:
ModelMaker http://www.modelmakertools.com/modelmaker/index.html
might be a good choice. Especially with the currently reduced prices.

Any sample of such documentation?

No, but I would not make it too complex or detailed, limit yourself
to high levels and the absolute minimum to avoid the doc getting
out of sync or becoming too complex to understand.
With tools like above, it is easy to visualize any part of the app in more detail
when required.


Gerrit Beuze
ModelMaker Tools


.



Relevant Pages

  • Re: UML Question (Object <-> ObjectFinder?)
    ... ER diagrams, Data flow diagrams, and ... The official notation for SM today is a subset ... It doesn't even use any stereotypes that aren't defined in UML. ... >> So long as the subclasses are substitutable, ...
    (comp.object)
  • Re: Humble opinion on UML
    ... I am not a real developer, but I use it sporadically since 1998 and I ... Even if one decides to employ OO techniques for a small application, it is even less likely that UML would be worthwhile for anything other that informal communication or sketching out design ideas. ... Activity Diagrams have been largely replaced by Abstract Action Languages because they are much easier to modify. ...
    (comp.object)
  • Re: Is UML appropriate for embedded systems ?
    ... Sequence diagrams are a good help in specifying ... The company I work for uses Rose for smartcard operating systems (a few ... The use of UML for our purpose is not obvious. ... usecases, but IMHO not for OSes or VMs ...
    (comp.arch.embedded)
  • Re: UML: Is it allowed to introduce custom stereotypes on classes? What about methods?
    ... >{enumeration} after the class name. ... I know UML knows such things as, ... >modelling methods as abstract or even static, ... understand these diagrams, understands the diagrams. ...
    (comp.object)
  • Re: Class Design Tools?
    ... you draw diagrams of your code ... light understanding of UML class diagrams. ... I do not answer questions on behalf of my employer. ... >> programmer helping programmers. ...
    (microsoft.public.dotnet.general)