EA Document Generation

[dltodd]

I wondered how easy it would be to have the RTF documents that are generated by the system, to be organized in a different structure. I create a folder to contain each UseCase, under that are other folders that manages each scenario that I document both with text in the scenario description and in an Activity Diagram. Is there anyway to put the diagrams at the beginning of the document and then present the Activity Diagram followed by the description of the individual steps that are outlined in the Activity Diagram. Unfortunately, having things in alphabetical order makes the organization of the document hard to understand.

Or another suggestion for a good template, I have followed Geri Schneider and Jason Winters examples in their book "Applying Use Cases". Their System Documents, UseCase Documents and Scenario Document Templates at http://books.txt.com and click on "templates" gives you there examples. Those work really well from a organization stand point. Or maybe there is a way for me to build my own template.

This maybe harder than I realize to do, but thought I would at least suggest it.

Dennis

[James]

I'd second Dennis' comments on reporting.  Unless you put everything in separate packages the alphabetical sorting means that actors, use-cases, objects etc are all jumbled-up in the reports.  I suggest that at least sorting by type before name would help, although there's bound to be some debate about the order in which types are sorted!

James

[gsparks]

Hi,

We are more than happy to review this - the difficulty of course is getting some consensus on what is a good ordering -

If people have some ideas on this, let us know and well try and come to some useful and generic solution.

Geoff Sparks

[dltodd]

I guess in response to your request for consense, I would still go back to my original suggestion.

I understand your position here as far as a good general setup. My recommendation would be to allow us to build some sort of template ourselves that gives us some control. This expands on your current template concept. So now when I ask for a template, it allows me to define what I want, where and in what order. If I have a UseCase and it uses other UseCases and it obviously has subelements of Classes, Scenarios, relationships, they appear in, etc., then let me give you that template to build the order from, also where to put the graphs, etc. You obviously have a bunch of Objects in the tool that can all be accessed by their type etc., so let us take advantage of that fact, create the document that way.

Having the template capability with structural control of the Document would get you, the creator out from deciding on how it should be laid out, and give us that control. Take advantage of what you have defined and take it a step further in the template concept. I think you would get a very positive response from that. If that works?! Maybe even use your "WorkSpace" to define the structure! Let us order any element that is available in the order we choose!

Hope that helps!

Dennis