Subject: Re: UML
From: Beth Agnew <Beth -dot- Agnew -at- senecac -dot- on -dot- ca>
To: "TECHWR-L" <techwr-l -at- lists -dot- raycomm -dot- com>
Date: Tue, 01 Jul 2003 12:54:57 -0400

Congratulations on the gig, John! As for UML, don't fall for the "automated documentation" features Rational purports to include or support (SoDa for Word comes to mind). They are a big waste of time. By the time you program them to pull out the information, you could have written the thing twice. And they can only pull out what has been put in (GIGO), which is generally quite bad. UML with Rational Rose was supposed to be a great aid to development, and it was -- for the developers. On the documentation side, it would have been very helpful to the writers, except that the developers were not putting IN the comments we needed so we still had to interview them anyway. Apart from that, it was indeed "fun".

Use cases are by far the best aspect of UML. I suggest writing your own narrative use cases, rather than relying on the ones in the software. Use cases are great for capturing specifications and requirements.

<facetious>But shouldn't you be looking for a UML expert instead?</facetious>

John Posada wrote:

What I need to know is this: Has anyone created documentation under the
umbrella of UML. What were the "gotchas"? What did you find out was the
biggest impact on what you do on a day to day basis? What was your biggest
obstacles. Did it improve what you create and if so, how?
Beth Agnew
Professor, Technical Communication
Seneca College of Applied Arts & Technology
Toronto, ON 416.491.5050 x3133


Create professional Help systems that feature interactive tutorials and
demos with all new RoboHelp Studio. More at

Mercer University's online MS Program in Technical Communication Management:
Preparing leaders of tomorrow's technical communication organizations today.
See or write George Hayhoe at hayhoe_g -at- mercer -dot- edu -dot-
You are currently subscribed to techwr-l as:
archive -at- raycomm -dot- com
To unsubscribe send a blank email to leave-techwr-l-obscured -at- lists -dot- raycomm -dot- com
Send administrative questions to ejray -at- raycomm -dot- com -dot- Visit for more resources and info.

UML: From: John Posada

Previous by Author: RE: ADMIN: Civility and content
Next by Author: Re: UML
Previous by Thread: Re: UML
Next by Thread: Re: UML

What this post helpful? Share it with friends and colleagues:

Sponsored Ads